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Preface 


This manual, 386! ASM Reference Manual, is intended for experienced 
systems developers. The programmers who will use it are assumed to be 
familiar with other, associated Phar Lap products, and to be well-informed 
on Intel architecture. This manual is not intended as a teaching device; it 
is for reference and informational purposes only. For other books and 
manuals on the process, please see the Related Documentation and Books 
section at the end of this preface. 


If, after you read this book, you find that you have suggestions, improvements or 
comments that can make this a better manual, please call us, write us or send us 
mail at: 


Phar Lap Software, Inc. 

60 Aberdeen Ave., Cambridge, MA 02138 
(617)661-1510, FAX (617)876-2972 
dox@pharlap.com 
tech-support@pharlap.com 


Your comments are very welcome. 


Manual Conventions 


This manual relies on certain conventions to convey certain types of 
information. On the following pages, these are the conventions. 


Courier indicates command line, switch syntax and examples; this 
typeface was chosen for its close resemblance to screen 
display and to differentiate actual command lines from 
documentation. 


{} Items enclosed in braces are optional. The statement will 
be valid if optional items are left out. 


xiii 


ae Indicates that the preceeding item may be repeated an 
arbitrary number of times, with adjacent items separated 
by commas. 


| Only one of a set of items separated by vertical bars may be 
used. 


Italics Items in italics-must be replaced with a symbol 
appropriate to a particular statement. The word in italics 
is generally a descriptive name that identifies a class of 
symbols that may be used. 


For example, a description of a statement to create 10-byte temporary real 
constant values is shown in the following notation: 


DT digits.{digits}{E{+|-}digits},... 


This indicates that a single real number is entered as a required integer 
part and a required decimal point, followed by an optional fraction part, 
and an optional exponent part that consists of a required character E, an 
optional + or - sign, and required exponent digits. The DT statement itself 
can be used to create an arbitrary number of real number constants by 
separating them with commas. Thus, any of the following statements are 
valid: 


DT i 

DT LSctiiat 2 

DT 1.0E2 

DT 1.0E+2 

DT 1.0E-2 

DT 1.E2 

DT 0. 

DT 0.E0 

DT 314.159E-2,0.31459E1 


All the examples in this manual use upper case characters for assembler 
directives and expression operators. Lower case is used for all other 
assembler reserved words and for all user-defined symbols. This 
convention is for readability only; upper or lower case may be used for all 
assembler reserved words and for all user-defined symbols. 
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Chapter 1 


Introducing 386! ASM 


3861 ASM is an assembler for the Intel 80386 microprocessor. It is a 
member of the 80386 Software Development Series from Phar Lap 
Software, Inc. 386! ASM is used to assemble one or more assembly 
language source code files into a single object module. 386! ASM also 
assembles programs for the 8086, 8088, 80186, 80188, 80286, 80386, and 80486 
microprocessors. Versions of 386! ASM which run on the IBM PC or 
PC/AT, VAX/VMS, and a number of different UNIX systems are 
available. 


When 3861! ASM is used to assemble code for the 8086, 8088, 80186, 80188, 
or 80286, it generates object modules that conform to the Intel 8086 Object 
Module Format (OMF-86). When code is assembled for the 80386, a 
simple extension to OMF-86, called Easy OMF-386, is used for the object 
file format. Appendix K describes the Easy OMF-386 object file format. 


386 | ASM works with software products which generate Microsoft MASM 
compatible assembly language source code, or which process 
Intel/Microsoft standard Object Module Format (OMF-86) object files. 
386 | ASM has been tested with the following products, and no problems 
have been found: 


8086 mode: 
Phar Lap 386! LINK Version 1.0 or later 
Microsoft LINK Version 3.0 or later 
Microsoft LIB Version 3.0 or later 
80286 mode: 


Phar Lap 386! LINK Version 1.0 or later 
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80386 mode: 


Phar Lap 3861 LINK Version 1.0 or later 
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Chapter 2 


Using 386! ASM 


2.1 Command Line Syntax 


The command line used to run the assembler is the name of the 
assembler task image (386asm on IBM PC systems), followed by a list of file 
names and switches. The switches are used to override the default 
operation of the assembler. By default, 386! ASM assembles one or more 
input (source code) files and creates an output object file and an output 
listing file. When errors occur during assembly, an error message is 
displayed on the screen and written to the listing file. A switch may be 
used to redirect error messages displayed on the screen to an error list file. 


A file name can be specified on the command line as a complete file name 
(filename.extension), or can be given without an extension, in which case 
3861 ASM supplies a default file extension. The assembler assumes the 
following file name extensions when none are specified: 


Default Extension Default Extension 


on IBM PC/ on VAX/VMS 
File Type MS-DOS and UNIX 
input source file .ASM .A86 
output object file .OBJ .086 
output listing file . LST .LIS 
output error list file .ERR .ERR 


In addition, a complete or partial path may be specified with the file name. 
If none is given, the current default device and directory are assumed. 


Switches begin with a minus sign (-) followed by the name of the switch. 
No spaces are permitted between the minus sign and the switch name. 
Any arguments to the switch must immediately follow the switch, with 
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spaces as separators. Adjacent input file names may be separated by spaces 
and/or commas. Adjacent switches, or an adjacent switch and input file 
name, must be separated by spaces. Input file names and switches may be 
placed in any order on the command line. Input file names may not 
begin with a minus sign, so that 386! ASM can distinguish between file 
names and switches. Some examples of valid command lines are shown 
below, and more examples are given in Appendix L. 


Example: 


Assemble the input files TEST1.ASM and TEST2.ASM to generate an 
object file TEST1.OBJ, a listing file TEST1.LST, and an error list file 
TEST1.ERR: 


386asm testl test2 -errorlist testl 
386asm testl,test2 -el testl 
386asm -el testl testl test2 


Assemble the input files TEST1.ASM in the current directory and test2.A 
in a subdirectory SUBD of the current directory, and create listing and 
object files in the top level directories LISTD and OBJD on the current 
default disk: 


IBM PC/MS-DOS 
386asm testl1,subd\test2.a -list \listd\testl -o \objd\testl 


VAX/VMS 
xa386 testl,[.subd]test2.a -l1 [listd]testl -o [objd]testl 


UNIX 
xa386 testl,subd/test2.a -1 /listd/testl -o /objd/testl 


2.2 Command Line Switches 


Command line switches are used to change the default operation of 
3861 ASM. By default, 3861 ASM will: 


Create an object file with the same name as the first input file and the default 
file extension shown in section 2.1. 


Create a listing file with the same name as the first input file and the default file 
extension shown in section 2.1. 


@ Assume the 80386 as the target processor. 
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# Will not assemble instructions for an 8087 or 80287 floating point 
coprocessor. 

Perform a case-insensitive assembly (upper and lower case versions of a symbol 
are considered identical). 


Command line switches begin with a minus sign (-) followed by the name 
of the switch. There are two forms of each switch name: a long form and 
a short form. Any argument to the switch must immediately follow the 
switch name, with a space as a separator. If conflicting switches are given 
on a command line, the last (rightmost) switch takes precedence. 


2.2.1 Object File Switches 


The -OBJECT switch is used to give the object file a name other than the 
default name assigned by the assembler, or to place the object file in a 
directory other than the current default directory. 


Syntax: 
-OBJECT filename 


Short Form: 


-O filename 


Example: 
IBM PC/MS-DOS 


386asm test -o test.o 

386asm test -object t.obj 
386asm test -o \objdir\test 
386asm test -o \objdir\test.o 


VAX/VMS 
xa386 test -o [objdir]test 


UNIX 
xa386 test -o /objdir/test 


The -NOOBJECT switch instructs 3861 ASM not to generate an object file. 
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Syntax: 
-NOOBJECT 

Short Form: 
-NOO 

Example: 


386asm test -noobject 
386asm test -noo 


The -NODELETE switch instructs 386! ASM not to delete the .OBJ file, 
even if there are severe errors in the assembly. By default, the .OBJ file is 
deleted when severe errors occur. 
Syntax: 

-NODELETE 
Short Form: 

-NOD 
Example: 


386asm test -nodelete 
386asm test -nod 


2.2.2 Listing File Switches 


The -LIST switch is used to give the listing file a name other than the 
default name assigned by the assembler, or to place the listing file in a 
directory other than the current default directory. 


Syntax: 
-LIST filename 


Short Form: 


-L filename 
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Example: 


IBM PC/MS-DOS 


386asm test -list test.1l 
386asm test -l \listdir\test 


VAX/VMS 
xa386 test -l DRA1: [listdir]test 


UNIX 
xa386 test -l1 /listdir/test.l 


The -NOLIST switch instructs 386! ASM not to generate a listing file. 


Syntax: 
-NOLIST 

Short Form: 
-NOL 

Example: 


386asm test -nolist 
386asm test -nol 


The -NOSYM switch instructs 386! ASM not to generate a symbol table 
summary at the end of the source file listing. 


Syntax: 
-NOSYM 


Short Form: 
-NOS 


Example: 


386asm test -nosym 
386asm test -nos 
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2.2.3 Error List File Switch 


The -ERRORLIST switch is used to specify a file in which to place error 
messages. By default, error messages are displayed on the terminal. Error 
messages are always placed in the listing file (if one is generated) even if 
an error list file is generated. 


Syntax: 


—-ERRORLIST filename 


Short Form: 


-EL filename 


Example: 
IBM PC/MS-DOS 


386asm test -errorlist test 
386asm test -el test.e 


VAX/VMS 
xa386 test -el t.err 


UNIX 
xa386 test -el /listdir/test 


2.2.4 Include Search Directory Switch 


The -INCLUDE switch is used to specify one or more directories to search 
for files included with the INCLUDE directive (please see section 3.5). By 
default, only the current default directory is searched for include files. If 
one or more include search directories are specified on the command line, 
386! ASM attempts to locate include files by searching the specified 
directories in the order they were given on the command line (left to 
right) before searching the current default directory. 


More than one include search directory can be specified by putting more 
than one -INCLUDE switch in the command line, or by giving a single - 
INCLUDE switch more than one argument. If multiple search directories 
are specified with a single -INCLUDE switch, they must be separated by 
commas, with no spaces between arguments. 
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The assembler attempts to locate files by appending the file name given in 
the INCLUDE statement in the source file to the directory specified with 
the -INCLUDE switch. Include directories should therefore be specified in 
the same manner used to specify file paths on the host system, and paths 
relative to the current directory can be used. 


Syntax: 


-INCLUDE dirname{, dirname... } 


Short Form: 


-I dirname{,dirname...} 


Example: 
IBM PC/MS-DOS 


386asm test -include \includes\ 
386asm test -i \includes\,isubdir\ 
386asm test -i ..\includes\ 


VAX/VMS 
xa386 test -i [includes] -i [.isubdir] 
xa386 test -i [-.includes] 


UNIX 


xa386 test -i /includes/,isubdir/ 


Please see also: INCLUDE (3.5) 


2.2.5 Instruction Set Switches 


The instruction set switches are used to enable assembly of instructions 
for a specific processor (8086, 8088, 80186, 80188, 80286, or 80386) and a 
specific numeric coprocessor (none, 8087, 80287, or 80387). By default, 
assembly of instructions for the 80386 processor are enabled, and the 
numeric coprocessor instructions are disabled (the switches to select those 
options are therefore redundant, but are provided for consistency). 


Specific instruction sets may also be enabled by using the instruction set 
directives (section 8.2). Use of the directives will override the command 
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line switches. Note that the 80286 and 80386 instruction sets both contain 
protected instructions that will only be executed by the processor if it is 
executing at privilege level zero. The 80286 and 80386 instruction sets 
may therefore be enabled for non-protected instructions, or for the full 
(including protected) instruction set. 


The -8086 switch enables assembly of 8086 and 8088 instructions. 
Syntax: 
-8086 


Short Form: 
-86 
Example: 


386asm test -8086 
386asm test -86 


The -80186 switch enables assembly of 80186, 80188, 8086, and 8088 
instructions. 


Syntax: 
-80186 


Short Form: 
-186 
Example: 


386asm test -80186 
386asm test -186 


The -80286 switch enables assembly of 80286 non-protected instructions, 
and 80186, 80188, 8086, and 8088 instructions. 


Syntax: 
-80286 
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Short Form: 
-286 


Example: 


386asm test -80286 
386asm test -286 


The -80286P switch enables assembly of all 80286, 80186, 80188, 8086, and 
8088 instructions, including protected instructions. 


Syntax: 
-80286P 


Short Form: 
-286P 


Example: 


386asm test -80286P 
386asm test -286P 


The -80386 switch enables assembly of 80386 non-protected instructions, 
80286 non-protected instructions, and the 80186, 8086, 80188, and 8088 
instructions. This is the default mode of the assembler. 


Syntax: 
-80386 


Short Form: 
-386 


Example: 


386asm test -80386 
386asm test -386 


The -80386P switch enables assembly of all 80386 instructions, including 
protected instructions. | 
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Syntax: 
-80386P 


Short Form: 
-386P 


Example: 


386asm test -80386P 
386asm test -386P 


The -8087 switch enables assembly of instructions for the 8087 numeric 
coprocessor. 
Syntax: 
-8087 
Short Form: 
~87 
Example: 


386asm test -8087 
386asm test -87 


The -80287 switch enables assembly of instructions for the 80287 and 8087 
numeric coprocessors. 


Syntax: 
-80287 


Short Form: 
-287 
Example: 


386asm test -80287 
386asm test -287 
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The -80387 switch enables assembly of instructions for the 80387, 80287, 
and 8087 numeric coprocessors. 
Syntax: 

-80387 


Short Form: 
-387 


Example: 


386asm test -80387 
386asm test -387 


The -NO87 switch disables assembly of instructions for a numeric 
coprocessor. This is the default mode of the assembler. 
Syntax: 

-NO87 


Short Form: 
-NO87 


Example: 


386asm test -no87 
386asm test -no87 


Please see also: Instruction Set Directives (8.2) 


2.2.6 Case Sensitivity Switches 


By default, 386| ASM is insensitive to the case of user-defined symbols. 
For example, the symbols “my_sym”, “my_SYM”, and “MY_SYM” are all 
considered identical by 386! ASM. A command line switch can be used to 
make 386! ASM perform case-sensitive assembly. If this option is 
enabled, the three symbols in the above example are all considered to be 
different. Whether case sensitivity is enabled or not, all upper and lower 
case versions of assembler reserved words are considered identical. 
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The -TWOCASE switch enables case-sensitive assembly of input files. 
When this switch is used, upper and lower case versions of the same 
symbol are considered to be different. 


Syntax: 


-TWOCASE 


Short Form: 


-TWOC 


Example: 
386asm test -twocase 


386asm test -twoc 


The -ONECASE switch disables case-sensitive assembly of input files. 
This is the default mode; this switch is therefore redundant but is 
provided for consistency. 


Syntax: 


-ONECASE 


Short Form: 
-ONEC 


Example: 


386asm test -onecase 
386asm test -onec 


2.2.7. Symbol Definition Switch 


The -DEFINE switch is used to define text symbols that can be referenced 
within the source code being assembled. This feature is useful for 
conditional assembly of blocks of code. The existence of a symbol can be 
tested with the IFDEF and IFNDEF directives (please see sections 8.4.3 and 
8.4.4), and the value of the symbol can be tested with the IFIDN and IFDIF 
directives (please see sections 8.4.7 and 8.4.8). Note that text symbols can 
also be created within the source code with the EQU directive. If no string 
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is specified when the symbol is defined, it is assigned a value equal to the 
null string. 
Syntax: 
-DEFINE symbol {=string} 
Short Form: 
-D symbol{=string} 
Example: 


386asm test -define cross_mode 
386asm test -d opsys=xenix 


Please see also: IFDEF (8.4.3), IFNDEF (8.4.4), IFIDN (8.4.7), IFDIF (8.4.8), 
EQU (4.2.2) 


2.2.8 Extra Error Checking Switch 


The -FULLWARN switch is used to turn on extra error checking in 

3861 ASM. When extra error checking is enabled, 386! ASM generates 
warning errors when the use of a specific segment register is implied in an 
instruction, but no ASSUME directive has been given assigning the 
segment register to a segment. The purpose of these errors is to remind 
the programmer to make sure the segment register points to the correct 
segment. 


Warning errors are also generated when forward references to symbols 
cause NOP instructions to be generated because the assembler reserves 
more space for the instruction on pass one of the assembly than is actually 
needed on pass two. It is usually possible to get rid of the NOPs by giving 
3861 ASM more information about the forward referenced symbol with 
the PTR operator (please see section 9.3.7). 


2.3 Listing File Description 


The listing file created by 386! ASM shows (1) source code lines from the 
input file, (2) the object code generated by the assembler for each source 
line, and (3) summary tables showing all the user-defined symbols. The 
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listing file is broken up into pages for readability, with a page header 
printed at the top of each page. 


A single line of the listing file looks like this: 


offset object source 


where offset gives the offset, in hexadecimal, from the beginning of the 
segment to the generated object code; object shows the generated object 
code in hexadecimal; and source shows the source code line as it appears in 
the input file. For example: 


00000000 cseg SEGMENT word public 
00000000 B8 00000001 mov eax,1 
00000005 cseg ENDS 


If an error is detected in a particular source code line, an error message is 
printed in the listing file immediately following the line in which the 
error appears. The error message identifies the source code file and the 
number of the line within the source file which caused the error. It also 
prints an error number and a message describing the error. For a more 
complete description of specific error numbers, please see Appendix B. 


At the end of the listing file, several symbol tables are printed showing all 
the user-defined symbols in the program. The sections below describe the 
symbol tables in the order they appear in the listing file. If there are no 


symbols in a particular category, the symbol table for that category is not 
printed. 


2.3.1 Page Header 


386 ASM prints out a five-line page header at the top of each page of the 
listing file. The first line identifies the version number of the assembler 
and gives the date and time of the assembly. The second line is blank. 
The third line displays the title, if any, specified with the title directive, 
and has a section and page number. The section number starts at one and 
increases incrementally under control of the PAGE directive. The page 
number is set to one at the beginning of each section and is incremented 
at every page break. The fourth line of the page header displays the 


og if any, specified with the SUBTTL directive. The fifth line is 
ank. 
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Example: 


Phar Lap Macro Assembler Version 3.0 Mon Nov 03 09:21:15 1990 
Initialization Code Page 1-5 
setup gdt - init global descriptor table 


00000000 setup gdt PROC. near ~ 
00000000 55 push ebp 


00000001 8B EC mov ebp, esp 


Please see also: TITLE (8.3.1), SUBTTL (8.3.2), PAGE (8.3.3) 


2.3.2 Statement Lines 


A source code statement is printed on a single line of the listing file in the 
following format: 


offset object source 


Offset gives the offset, in hexadecimal, at which the object code is located 
within its segment. 


Object shows the object code generated for the statement; if no object code 
is generated, this field is blank. Normally, object code is printed as a string 
of hexadecimal bytes in the same order in which they are output to the 
object file, with a space between each byte. However, word and 
doubleword values such as constants or offsets within a segment are 
printed, most significant byte first for readability. No spaces are printed 
between the bytes of word and doubleword values that are ordered most 
significant byte first. Several special characters are used in the object code 
field in the listing file. Table 2-1 lists each special character and its use. 


The source field in the listing file contains the source code statement, 
copied exactly as it appears in the source code file. One of several special 
characters may be printed immediately to the left of the source code field. 
Table 2-2 lists the special characters used with the source code field and 
their meanings. 
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TABLE 2-1 
SPECIAL CHARACTERS IN OBJECT CODE FIELD 


Character Usage Description 


R value R The value is relocatable; its final value is determined 
when the program is linked or loaded. 


value E The value is defined externally to the module being 
assembled; its final value is determined when the 


program is linked. 


---- ----R A segment selector value. The final value is 
determined when the program is loaded for execution. 


= = value A constant symbol whose hexadecimal value is value 
has been created. 


= mnemonic _Analias symbol for the assembler reserved word 
mnemonic has been created. 


A text substitution symbol has been created with the 
EQU directive. 


0G A segment override prefix byte, with hexadecimal 
value xx, has been output. 


/ xx/ A REP or LOCK prefix byte, with hexadecimal value 
xx, has been output. 


An operand size override prefix byte has been output. 


An address size override prefix byte has been output. 


(] count{value] _ The hexadecimal value value has been replicated count 
times by the DUP operator. 


One or more bytes of uninitialized memory has been 
reserved with the ? operand, where two ? characters 
are printed for each byte of reserved space. 


18 386IASM Reference Manual 


Using 386IASM 


TABLE 2-2 
SPECIAL CHARACTERS IN SOURCE CODE FIELD 


Character Meaning 


The source statement was read from a file that was included with the 
INCLUDE directive. 


n Macro and repeat block expansion depth (one — nine). 
+ Macro and repeat block expansion depth is greater than nine 


Example: 
. LALL 
INCLUDE macros.asm 
I ml MACRO 
He REPT 2 
I DB 0 
I ENDM 
BA ENDM 
ASSUME cs:cseg 
00000000 cseg SEGMENT word public 
use32 
EXTRN cval:abs 
= 0000000A cval2 EQU 10 
= 0000000B cval3 = 11 
= EBP stk_frm EQU ebp 
= copy EQU "Copy' 
00000000 QOOOOO0O00A[ 61 62] bvar DB 10 dup('ab') 
00000014 43 6F 70 79 DB copy 
00000021 22??? DW Fs 
ml 
1 REPT 2 
1 DB 0 
1 ENDM 
00000023 00 z DB 0 
00000024 00 2 DB 0 
00000025 aD push stk_frm 
00000026 8B EC mov stk_frm,esp 
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ey ee 


00000028 66| B8 OO0A mov ax,cval2 
0000002C B8 00000000 E mov eax, cval 
00000031 8D 05 00000000 R lea eax, bvar 
00000037 2E: AO 00000000 R mov al,bvar 
0000003D 66| B8 ---- R Mov ax,cseg 
00000041 F3/ A4 rep movsb 
00000043 cseg ENDS 


i 


2.3.3 Group and Segment Symbol Table 


The group and segment symbol table shows all the groups and segments 
defined in the source code file. Segments within a group are indented. 
All segments that are not in a group are listed after all groups. Segment 
entries in the table also show the use attribute, align type, combine type, 
and class string for the segment. 


Example: 
GROUPS AND SEGMENTS 

Name Size Use Align Combine Class 
DGROUP . .«-. Group 

CONST « .« OO00000A USE32 DWORD PUBLIC DATA 

PAT 5. 00000258 USE32 DWORD PUBLIC DATA 
CSEG a age 00001560 USE32 WORD PUBLIC CODE 
STACK . | « 00001000 USE32 DWORD STACK STACK 


Please see also: SEGMENT (3.7), GROUP (3.9) 


2.3.4 Structure Symbol Table 


The structure symbol table shows all the structure definitions and 
structure fields defined in the source code file (structure variables are 
shown in the variable symbol table). Fields within a structure are 
indented. The size in bytes of each structure is given, and the size in bytes, 


offset in bytes from the beginning of the structure, and data type are 
shown for each structure field. 
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STRUCTURES 
Name Size Offset 
PTRIGG « « & « 00000006 
SOFES «. « * 00000004 00000000 
SELECTOR . 00000002 00000004 


Please see also: Structure Definitions (6.6) 


2.3.5 Record Symbol Table 


Using 3861ASM 


Type 


DWORD 
WORD 


The record symbol table shows all the record definitions and record fields 
defined in the source code file. (Record variables are shown in the 
variable symbol table). Fields within a record are indented. The size in 
bits, the mask value, and the initial value are shown for both the record 
and record fields. Fields also show the offset in bits of the field within the 


record. 
Example: 
RECORDS 
Name Size Offset Mask 
ae sw wh 16 QO00003FF 
Fi« «w= * 2 8 00000300 
Pe wwe ww 5 8 0 OOOO000FF 


Please see also: RECORD (6.9) 


2.3.6 Macro Symbol Table 


Initial Value 


0000000A 
00000000 
OOO00000A 


The macro symbol table shows all the macros defined in the source code 
file. Each entry shows the number of formal parameters and the number 


of source code lines in the macro. 
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Example: 
MACROS 
Name #Params #Lines 
Gl add ...» 2 2 
Gal malt . . 2 8 


Please see also: Macro Definition (10.2) 


2.3.7 Procedure Symbol Table 


The procedure symbol table shows all the procedures defined in the 
source code file. It also shows all local variables, labels, and constants 
defined within each procedure. For each procedure, the data type (NEAR 
or FAR), offset of the procedure within the segment, its scope (“Public”, if 
it has been made available to other modules with the PUBLIC directive, 
“Prvate”, if it has not), and the name of the segment in which it is located 
are shown. Each entry for a local variable, label, or constant gives the 
same information described in the sections on the variable and label 
symbol table and the constant symbol table, with one exception. The scope 
is always given as “Local”, indicating a local symbol which may only be 
referenced from within the procedure in which it is defined. 


Example: 
PROCEDURES 
Name Type Offset Scope Segment 
init gg& .. . N PROC 0000000A Public cseg 
mkt 28> a. -e-~ N PROC 00001A10 Public cseg 
SHAE I. ke N PROC 00000420 Public cseg 
init_paget .. N PROC 00001038 Public cseg 
LOCAL VARIABLES AND LABELS 
| eee N LABEL 00001060 Local cseg 
we ae 3 N LABEL 00001074 Local cseg 
#ecode .. WORD 000018F0 Local cseg 
LOCAL CONSTANTS 
fazgl .-. Integer 00000008 
#arg2 .. Integer 0000000C 
ac. Gir «+. . N PROC 00001F08 Prvate cseg 
22 
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Please see also: Procedure Blocks (5.3), Global Symbol Definitions 
(Chapter 7) 


2.3.8 Variable and Label Symbol Table 


The variable and label symbol table shows all variables and labels defined 
in the source code file, except those that are local to a procedure block. 
Each entry shows the data type of the label or variable, its offset in the 
segment in which it is defined, its scope (“Extern”, if it has been declared 
with the EXTRN directive, “Public”, if it has been made available to other 
modules with the PUBLIC directive, and “Prvate”, if it is not a global 
symbol), and the name of the segment in which it is located. 


Example: 
VARIABLES AND LABELS 
Name Type Offset Scope Segment 
ecode ... DWORD O0O00000A Prvate dseg 
err exit . N LABEL 00000256 Extern cseg 
Flagl « « « Record 0000000C Prvate dseg 
GGe so - w « Struc 00000010 Public dseg 


Please see also: Variables and Data Definitions (Chapter 6), Global 
Symbol Definitions (Chapter 7) 


2.3.9 Constant Symbol Table 


The constant symbol table shows all constant symbols defined in the 
source code file (with the EQU and = directives), except those local to a 
procedure block. The type of each constant is given: “Integer” for a 
constant integer value, “Alias” for an alias to an assembler reserved word, 
or “Text” for a text substitution symbol. The value of each constant is also 
given. For integer constants, the value is printed in hexadecimal, or the 
word “Extern” is printed if the symbol was defined with the EXTRN 
directive. In addition, if it has been made available to other modules with 
the PUBLIC directive, it is identified as “Public”. For alias constants, the 
symbol is identified as an alias for an instruction mnemonic, an assembler 
directive, a register name, an expression operator, or an assembler 
keyword. The assembler reserved word for which the symbol stands is 
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also printed. For text substitution symbols, the text string that is 
substituted for the symbol when it is encountered is shown. 


Example: 
CONSTANTS 
Name Type Value 
ot Ai ae Text (pword PTR gdtlim) 
figmak .. Integer 0000003C 
gdt size .. Integer Public 00000050 
stk frame . Alias Register: EBP 


Please see also: Defining Constants With the EQU and = Directives 
(Chapter 4), -DEFINE (2.2.7), Global Symbol Definitions 
(Chapter 7) 
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Program Organization 


Introduction 


This chapter defines the basic structure of a program assembled with 
386! ASM. The first section describes the format of a source file. 
Following sections describe the directives dealing with module naming, 
entry point specification, file inclusion, program segmentation, and 
location counter control. 


The section describing program segmentation is a reference for how to use 
the segmentation directives. It is not intended as a description of the 
segmented architecture of the 80386, nor is it a description of how 
segments can be used to build a program. For a general overview of the 
80386 and its segmented architecture, please see Chapter 11. 


3.2. 386|ASM Source File Format 


During an assembly, 386! ASM reads statements from one or more source 
files and writes output to an object file and a listing file. The object file 
contains a binary representation of the statements in the source file in a 
form which can be processed by 386! LINK. The listing file shows the 
format of all source statements which were assembled, along with the 
object code they generated. 


A source file is an ASCII text file. It may not contain control codes, except 
inside string constants, or codes which separate lines of text. A complete 
description of the valid character set appears in Appendix C. 


A source file assembled by 386! ASM contains Zero or more source 
statements, followed by a source statement containing an END directive. 
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If the END directive is missing, the assembler supplies one after the last 
line of the last input file processed. 386! ASM requires all instruction and 
data bytes emitted to reside in a named section called a segment. A typical 
source file contains one or more segment definitions before its END 
statement. 


Please see also: Syntactical Elements (Appendix C) 


3.2.1 Statement Format 


A source code statement must be on a single line in the source file. It can 
be no longer than 132 characters in length. The format of a source 
statement is: 


{identifier} mnemonic {operand,...} {; comment} 


Identifier is an optional user-defined symbol. Mnemonic is an instruction 
mnemonic or a directive name. This is followed by an optional list of 
operands to the instruction or directive, separated by commas. An 
optional comment field begins with a semicolon. 


Example: 
PAGE 
DW 0,0 ; Allocate two zero words 
wvar DW 1 ; Define a word variable 


3.2.2 Symbol Formation 


User-defined symbols are a sequence of characters from the following set: 


A user-defined symbol may not begin with a digit. Only the first 31 
characters in a symbol name are significant; all others are ignored. Upper 
and lower case versions of a symbol are considered identical unless case 
sensitivity is enabled with the -TWOCASE command line switch. 
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Example: 
sym0 DB ? 
_sym?1 DW : 
@sym 2 SEGMENT word public use32 
ols 


386 | ASM also supports local symbols within procedures. A local symbol 
is defined by beginning the symbol name with the pound character ’(#). 
The rest of the characters in the symbol name follow the normal rules for 
symbol formation. The pound character may not be used in any character 
position other than the first character in the symbol name. Local symbols 
are only known within the scope of the procedure in which they are 
defined. Thus, a local symbol name may be reused in different procedure 
blocks without causing multiply defined symbol errors. 


Example: 
add_dbl PROC near ; add two doublewords 
#argl EQU 8 ; lst argument 
#arg2 EQU iz ; 2nd argument 
push ebp ; set up 
mov ebp, esp ; stack frame 
mov eax,#argl[ebp] ; add two 
add eax, #arg2[ebp] ; arguments 
jo #error ; set error if overflow 
#exit: 
pop ebp ; restore original EBP 
ret 
#error: call ovf_err ; call error routine 
jmp #exit 


add_dbl  ENDP 


Please see also: -TWOCASE (2.2.6), Procedure Blocks (5.3) 


3.2.3 Constants 


3861 ASM supports all of the data types and formats supported by the 
8086/8088 /80186 /80188 /80286/ 80386 and by the 8087/80287 coprocessors. 
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Integers are encoded in two’s complement, and may be one, two, four, 
eight, or ten bytes in length. Real numbers are encoded in the 80287 
floating point format and may be four, eight, or ten bytes in length. 
Packed decimal numbers are encoded in the 80287 packed decimal format 
and are always ten bytes in length. Appendix G gives the range of values 
that can be represented by each data type. All numbers are stored least 
significant byte first in memory. For a complete description of 80386 and 
8087 /80287 data formats, please see the list of related documents in the 
Preface. 


Please see also: Data Declaration Directives (6.2), Data Types 
(Appendix G) 


Integer Constants 


Syntax: 


digits{radix_specifier} 


Integer numbers are given as a string of one or more digits followed by an 
optional one-character radix specifier. Digits must be characters in the set 
0-9, and A-F or a-f for hexadecimal numbers. If no radix_specifier is given, 
the number is assumed to be in the current default radix (any base from 
base 2 to base 16). The default radix is initially base 10 and may be changed 
using the .RADIX directive. Radix specifiers are shown in Table 3-1. 


TABLE 3-1 


RADIX SPECIFIERS 


binary (base 2) 


decimal (base 10) 


hexadecimal (base 16) 


28 386IASM Reference Manual 


Program Organization 


All numbers, regardless of radix, must begin with a decimal digit (0-9); 
anything beginning with a letter is treated as a symbol instead of a 
number. A leading 0 can always be used, if necessary. The examples 
below all specify the decimal number 12, given in different radixes. 


Example: 
DW a2 ; decimal 
DW 0Ch ; hexadecimal 
. RADIX 16 ; set default to hexadecimal 
DB oc ; hexadecimal 12 
DD 140 : octal 
DQ 1100B ; binary 
DT 12d ; decimal 
. RADIX 11 ; set default to base 11 
DW a a B ; base 11 
DW 12D ; decimal 


Integer numbers are normally stored in a two’s complement format, 
which may be processed by either the 80386 or the 80287 coprocessor. The 
DT directive may also be used to create packed decimal numbers, stored in 
the 8087/80287 packed decimal format. A packed decimal number is 
created by the DT directive when the default radix is decimal and no radix 
specifier is used at the end of the number; otherwise, a normal two’s 
complement integer is created. The maximum size of a packed decimal 
number is 18 digits. 


Example: 
- RADIX 10 
DT 12345 ; packed decimal 
DT 12345D ; two's complement integer 
DT 123459 ; two's complement integer 
DT OABCDH ; two's complement integer 


Please see also: .RADIX (8.6.2) 


Real Constants 


Syntax: 
digits. {digits} {E{+|-}digits} 
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Real numbers are given as a required integer part, a required decimal 
point, an optional fractional part, and an optional exponent. The 
exponent, if present, begins with the required character “E”, and is 
followed by an optional + or - sign and required digits. All digits must be 
decimal (0-9). Real numbers may only be used with the DD, DQ, and DT 
data declaration directives. Real numbers are stored in 8087/80287 
floating point format. 


Example: 
DD 1.0 
DQ 1.0E20 
DT he 
DD 0.002E-10 
DD 1.0E+20 


Encoded Reals 


Syntax: 


digitsR 


Real numbers may also be entered in an encoded form. The programmer 
encodes the number in the floating point format used by the 8087/80287 
numeric coprocessor (or by some other numeric coprocessor or software 
floating point package). Encoded real numbers are given as a string of 
hexadecimal digits followed by the real number specifier R. Encoded real 
numbers may only be used with the DD, DQ, and DT directives, and the 
number of digits must be exactly the size of the data type. If the number 
has a leading 0, the number of digits may be, but does not have to be, 
increased by one. Thus, eight digits must be given with the DD directive, 
16 digits with DQ, and 20 digits with DT (or 9, 17, and 21, respectively, with 


a leading 0). 
Example: 
DD 1.0E1 
DD 41200000R 
DD -0.000123 
DD OB900F98FR 
30 
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DQ 1.0E38 

DQ 47D2CED32A16A1Blr 

DT 1.0E1 

DT 4002A000000000000000R 


String Constants 


Syntax: 


“strang" 
'string' 


String constants are a sequence of one or more characters enclosed in 
double quotation marks (") or right single quotation marks ('). The 
characters in string may be any printable ASCII character, any non- 
printable ASCII character except the NUL (0) character, and any non-ASCII 
character (a character with the most significant bit set). This allows 
graphics characters to be directly encoded in character strings. 


To encode the quotation mark that encloses the string as part of the string, 
the quotation mark character must be typed twice. 


String constants may be used with the DB directive to enter the character 
string in memory. Strings up to eight characters in length may also be 
used as integer values, provided they will not overflow the specified data 
type. The ASCII value of each character in the string is stored as one byte 
in the integer, with the rightmost character in the string stored as the least 
significant byte in the integer. 


Example: 
DB ‘thas is a string' 
DB "don't" 
DB ‘don''t! 
DB 1000 DUP ("STACK") 


; string encoded integers 


DW ‘ab' 

DD "abcd' 

DQ "abcdefgh' 
DW "ab'DUP (?) 
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3.3 NAME Directive 


Syntax: 


NAME modname 


The object file output by the assembler contains a header record with the 
name of the assembled module. 386! LINK uses this name when the 
module needs to be referenced. 


The NAME directive is used to set this module name in the object output 
file. The modname parameter can be a string of any length, though only 
the first 132 characters are significant. Only one NAME directive is 
permitted per module being assembled. If a module contains more than 
one NAME directive, an error is posted for each attempt to change the 
name, and the name specified by the first NAME directive is used. 


If the name of the module being assembled is not specified, the assembler 
assigns a default name using the following logic: 


1. If a title for the listing file pages is specified with the TITLE directive, the first six 
characters of the title string (or less if the string is not long enough) are used 
as the module’s name. 


2. If the module has no name and a title is not specified, the assembler assigns the 
name of the source code file to the module. 


Example: 
The following example creates a module named mod!1: 
TITLE This is the first module of the system 


NAME modl 
END 


If no name is specified, the first characters of the title are used, if available. 
This example creates a module named MTH386: 


TITLE MTH386 - An 80386 long arithmetic library 
END 


Please see also: TITLE (8.3.1) 
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3.4 END Directive 


Syntax: 

END {entry pt} 
The END directive is used to terminate assembly of the current module 
and to specify an optional entry point into the program. When the 
assembler encounters an END directive, it treats it as if it reached the end 
of the input file. Any text following the directive is ignored and is not 
copied into the listing file. If the assembler encounters an END statement 


while processing a file included with the INCLUDE directive, the effect is 
the same. All input files are closed, and the assembly is terminated. 


The optional entry point specifier entry_pt specifies the value to be loaded 
into the 80386 instruction pointer when execution begins. It can be any 
expression which evaluates to an address in the module. Only one 
module in a program may specify an entry point; otherwise, an error 
occurs when the program is linked. 


Example: 


The END directive in the example below terminates the assembly of the 
module and establishes the procedure start as the entry point of the 
program: 


TITLE Example of entry point specification with END 
code SEGMENT word public 
start PROC far 


mov eax,1 ; This will be the first 
; instruction 


Start ENDP 
code ENDS 


END Start 
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INCLUDE Directive 


Syntax: 
INCLUDE filename 


The INCLUDE directive is used to insert text contained in another file 
into the file being assembled. A file which is included typically contains 
definitions for a system’s data structures, global variables, and public 
procedures. Include files may be nested to any depth. 


The filename argument specifies the name of the file to be included in the 
assembly. The assembler first searches any include library directories 
specified on the command line by appending the filename parameter to 
each directory in its list and attempting to open the file using that name. 
If this fails, it attempts to open the file using the name specified. 


Example: 


The following example program includes definitions for its data 
structures and external functions from header files: 


TITLE Example of using INCLUDE 


INCLUDE dstruct.h 
INCLUDE extern.h 


code SEGMENT word public 
start PROC far 


mov ax, fieldl[ebx] fieldl is defined in 
astruct..h 
print_field is defined in 


extern.h 


call print field 


eo Me Me Oe 


ret 
start ENDP 


code ENDS 
END 


Please see also: .LISTI (8.3.6), XLISTI (8.3.7), -INCLUDE (2.2.4) 
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3.6 COMMENT Directive 


Syntax: 


COMMENT delim text delim 


The COMMENT directive causes the assembler to treat the text between 
the two occurrences of the delimiter delim as a comment. Comments are 
copied to the listing file but are not processed by the assembler. The first 
non-whitespace character past the directive is the delimiter for the 
comment. The second occurrence of the delimiter is not required to be on 
the same line as the COMMENT directive, thus permitting multi-line 
comments. The remainder of the text on the same line as the second 
delimiter is also treated as a comment. 


Example: 


An example of a multi-line comment follows: 


TITLE An example of a multi-line comment 
COMMENT * 


The text contained on these lines will be treated as a 
comment because the second occurrence of the delimiter does 
not occur until below. 


* End of COMMENT 
END 


3.7 SEGMENT Directive 


Syntax: 


segname SEGMENT {align} {combine} {useatr} {access} 
i*ciass*} 


The SEGMENT directive marks the beginning of a logical section of the 
module being assembled. All instruction and data bytes generated by the 
assembler are placed in the segment named segname until the ENDS 
directive is processed for that segment. When program modules are 
combined by the linker, all segments with the same name are 
concatenated and relocated. 
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The segname parameter specifies the name of the segment being opened. 
The optional parameters following the directive provide information for 
the linker and loader as to how the segment is to be used. These optional 
parameters may appear in any order, and the assembler decides which 
type each parameter is based on its value. If a parameter is not specified, a 
default is chosen by 3861 ASM. The logic used to pick a default depends on 
the parameter and is formally specified in the sections describing each 
parameter. 


386 | ASM permits a segment to be opened and closed more than once 
during an assembly and treats all segments with the same name as a 
single segment. When a segment is reopened, its location counter starts at 
the value it had when the segment was last closed. The assembler, 
however, requires that any optional segment attribute specifiers for a 
segment being reopened match those specified the first time the segment 
was opened. 


Segment definitions may be nested. When a segment is opened inside 
another segment, assembly into the enclosing segment is temporarily 
suspended. All data emitted by statements inside the nested segment are 
placed in that segment, and the location counter for the enclosing 
segment is not modified. When the ENDS directive is processed for the 
nested segment, assembly continues into the enclosing segment. Though 
nesting of segment definitions is permitted, these definitions may not 
overlap. The ENDS directive for a nested segment must precede the 


ENDS directive for the enclosing segment; otherwise, 386! ASM posts an 
error. 


The following sections describe each of the optional segment attribute 
specifiers, the values they may take on, and the significance of each value. 


Please see also: ENDS (3.8), GROUP (3.9), ASSUME (3.10) 
3.7.1 Align Type Specifier 


A segment’s align type informs the linker what values are permissible for 
the base address of the segment. When 386! LINK combines object 

modules to create an executable image, it guarantees that each portion of a 
segment has a base address compatible with its alignment type by padding 
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the space between segments with null bytes if necessary. The align type 
specifier can take on any one of the following values: 


Align Type 
BYTE 


WORD 


DWORD 


PARA 


PAGE 


PAGE4K 


Meaning 
Segment can be based at any address. 


Segment must be on a word boundary (base address 
must be even). 


Segment must be on a double word boundary (base 
address must be divisible by 4). 


Segment must be on a paragraph boundary (base address 
must be divisible by 16). 


Segment must be on a page boundary (base address must 
be divisible by 256). 


Segment must be on a 4 kilobyte page boundary (base 
address must be divisible by 4096). 


If no align type is specified for the segment, a default of PARA is used. 


3.7.2 Combine Type Specifier 


A segment’s combine type tells the linker how to combine segments 
having the same name. The combine type specifier must have one of the 
following values: 


Combine Type Meaning 
PUBLIC Segments with the same name having a PUBLIC 


combine type are concatenated by the linker to 
form a single segment. Each portion of the 
segment is relocated relative to the new segment 
base as it is combined. 
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STACK Segments with the same name having a STACK 
combine type are concatenated by the linker as if 
they had a PUBLIC combine type. The only 
difference is that for executable task image formats 
that support initialization of SS:ESP, the linker sets 
the initial values of the SS and ESP registers to 
point to the end of the segment. 


COMMON Segments with the same name having COMMON 
combine type are overlaid. Each of the component 
segments is relocated to the same address: the base 
of the composite segment. The length of the 
composite segment is the length of the biggest 
component. COMMON segments can have 
initialized data, although care should be taken not 
to initialize the same area in a COMMON segment 
to different values in two different modules. 


MEMORY The MEMORY combine type is a synonym for the 
PUBLIC combine type. This type is provided for 
Intel compatibility. 


AT address The AT specifier tells the assembler and the linker 
that the segment has a paragraph base of address 
when the program is executed. The address 
parameter can be any expression which evaluates 
to an absolute number. AT segments are intended 
for use with programs that are burned into PROM. 
These programs are generally linked in some 
absolute format such as Intel hex format. For 
programs which are linked as a relocatable task 
image (e.g., MS-DOS .EXE format), an AT segment 
cannot contain initialized data and is useful only as 
a template for data already in memory. An 
example of such an area is the screen memory 
buffer on an IBM-PC. 
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If the AT combine type is given for a segment, it 
must be the last segment attribute specifier on the 
line. Note also that an AT combine type implies a 
PARA align type. For this reason, no align type 
should be specified for a segment defined with an 
AT combine type. 


If a segment’s combine type is not specified when it is defined, it is given a 
default combine type of private and is not combined with any other 
segments. 


3.7.3 Use Attribute Specifier 


The use attribute specifier of a segment informs the assembler what value 
it should expect the D bit in the segment’s descriptor table entry (please see 
the list of related documents in the Preface) to be during execution. The D 
bit is used by the 80386 CPU in protected mode to decide whether the 
default operand and address mode sizes are 16 or 32 bits wide. 


The assembler needs to know what value the D bit will have during 
program execution in order to correctly generate address size and operand 
size override bytes. The use attribute specifier can have one of the 
following two values: 


Use Attribute Meaning 
USE16 The segment being created has a default 


operand and address size of 16 bits. All 
offsets for instruction and data references 
default to 16 bits, and instruction operands 
are given a default size of 16 bits. The 
segment being created is limited to a 
maximum size of 64K bytes. 

USE32 The segment being created has a default 
operand and address size of 32 bits. All 
offsets for instruction and data references 
default to 32 bits, and instruction operands 
are given a default size of 32 bits. 
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If the segment’s use attribute is not specified, a default is assigned based on 
the use attribute of its enclosing segment and the target CPU of the 
assembly. If the segment is nested inside another segment, it will be given 
the use type of the enclosing segment. If it is not nested, it will be assigned 
a default of USE32 if the target CPU is an 80386. Otherwise, a default of 
USE16 is assigned. 


Programs executing on the 8086/8088/80186/80188/80286 processors, or in 
real mode on the 80386, can only have USE16 segments. Programs 
executing in protected mode on the 80386 can have either USE16 or USE32 
segments. 


Please see also: Chapter 11, Appendix J 


3.7.4 Access Type Specifier 


The access type specifier defines how the segment can be accessed during 
program execution. It has any of the following values: 


Access Type Meaning 

RO The segment is a read only data segment. 

EO The segment is an execute only code segment. 
ER The segment is a readable code segment. 

RW The segment is a writable data segment. 


If no access type is specified for the segment, a default of ER is assigned. 
An access type is only specified if the target CPU is an 80286 or an 80386. 
8086, 8088, 80186, and 80188 CPUs do not support segment protection. 


3.7.5 Class Specifier 


The class specifier for a segment defines the name of the class of which it 
is amember. The class name is enclosed in single quotation marks and 


may be any length. If no class specifier is given for a segment, a default of 
the null class name is assigned. 
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386 | LINK uses a segment’s class name as part of its algorithm for deciding 
how to order segments in memory. Segments with the same class name 
are ordered contiguously in memory. If a segment isa member of the 
null class, it is ordered contiguously with all other segments which are 
also members of the null class. 


3.8. ENDS Directive 


Syntax: 


segname ENDS 


The ENDS directive terminates the current definition of segname and 
causes assembly to continue into the enclosing segment, if any. The 
current location counter value for the segment is saved and assembly 
continues again at that point if the segment is reopened. 


The segname parameter must be the name of the most recently opened 
segment. If it is the name of a different segment, a block nesting error 
occurs and no segment is closed. 


Note that the ENDS directive is also used to terminate a structure 
definition (please see section 6.6.2). The assembler uses the segname 
parameter to determine which usage of ENDS is intended. 


Example: 


The following example shows code, data, and stack segments created for a 
module being assembled for an 8086 target CPU: 


dseg SEGMENT word public ‘'data' 
dseg ENDS 
cseg SEGMENT word public 'code' 
cseg ENDS 
sseg SEGMENT word stack ‘'stack' 
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sseg ENDS 


This example demonstrates correctly nested segments: 


cseg SEGMENT 
dseg SEGMENT 
dseg ENDS 


cseg ENDS 


A segment which can be overlaid on the screen memory of an IBM-PC 
with a CGA display controller board looks like this: 


scrseg SEGMENT at 0B800h 
; Template for screen memory goes here. 


scrseg ENDS 


Finally, an example of some 16- and 32-bit 80386 segments: 


dseg SEGMENT dword public use32 'data' 


dseg ENDS 


csegl6 SEGMENT word public usel6 ‘codel6' 


csegl1l6 ENDS 


cseg32 SEGMENT dword public use32 'code32'! 


cseg32 ENDS 


Please see also: SEGMENT (3.7) , ENDS (6.6.2) 
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3.9 GROUP Directive 


Syntax: 


groupname GROUP segname,... 


The GROUP directive is used to define a group of one or more segments, 
causing all segments in the group to be relocated relative to the base 
address of the first segment in the group. The groupname parameter 
defines the name of the group and must be unique. The segname 
parameter must be the name of a segment defined in the module. 


Note that a group definition does not affect how the segments are ordered 
in memory. Ordering is done with the class specifier of each segment. 
The group directive is only used to establish the fact that several segments 
are accessed with one segment register and should thus be relocated 
relative to the same segment base. It is possible to have segments which 
are not in a group located between those which are ina group. The only 
restriction is that the end of the last segment in the group must not be 
more than four gigabytes (for an 80386 link) or 64K bytes (for a link with 
any other target CPU) from the beginning of the first segment in the 
group. This problem should never occur in an 80386 link, but it is 
signaled by fixup overflow errors in an 8086 link. 


Example: 


Most C programs have several segments for data which are combined into 
one group. One is for constant data, one is for variables, and one is for the 
stack. At runtime, however, all three segments are accessed from the DS 
segment register. The following code is used to inform 386! ASM of this 
program structure, so it can generate correct relocation information for 
the linker: 


const SEGMENT word public 'CONST' 


const ENDS 


data SEGMENT word public 'DATA' 


data ENDS 
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stack SEGMENT word stack 'STACK' 


stack ENDS 


dgroup GROUP const, data, stack 
ASSUME ds:dgroup 


Please see also: SEGMENT (3.7), ASSUME (3.10), Chapter 11 


3.10 ASSUME Directive 


Syntax: 


ASSUME regname:segname|regname:NOTHING,... 
ASSUME NOTHING 


The ASSUME directive is used to inform the assembler what values the 
segment registers have during program execution. The regname 
parameter must be the name of one of the segment registers: CS, DS, ES, 
FS, GS, SS. (FS and GS are allowed only when the assembly is targeted for 
an 80386 CPU.) Segname must be the name of a segment or group defined 
in the module being assembled. The keyword NOTHING can be used 
instead of the segname parameter to indicate that the register will not 
point at any segment in the program. It can also be used instead of the 
regname parameter as shorthand to say that all segment registers contain 
undefined values. If the same register name is used more than once in an 
ASSUME directive, no error is signaled and the last (rightmost) value 
assumed is the one used. 


The assembler uses the segment register assumptions to establish 
addressability of data and instruction references and to generate segment 
override bytes where necessary. It is to the programmer’s advantage to be 
as complete as possible in telling the assembler what values the segment 
registers have whenever they change. 


Example: 


; Assume CS points at the program's code and DS points 
7; at nothing. 


ASSUME cs:code,ds:nothing 
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; No assumptions are valid. 
ASSUME nothing 


; Assume CS points at the program's code and all other 
; registers point at the data group. 

ASSUME cs:code,ds:dgroup,es:dgroup, ss:dgroup 

ASSUME fs:dgroup,gs:dgroup 


Please see also: SEGMENT (3.7), GROUP (3.9), Chapter 11 


3.11 Location Counter Control Directives 


The assembler maintains a location counter for each segment defined in a 
module. The location counter is the offset where the next instruction or 
data bytes are assembled into the segment. 3861 ASM provides several 
directives for changing the current value of the location counter if 
necessary. 


3.11.1 ORG Directive 


Syntax: 


ORG expression 


The ORG directive is used to set the current value of the location counter. 
The expression parameter is any expression which evaluates to an absolute 
number or an offset in the current segment. The ORG directive only 
affects the location counter in the currently open segment. The location 
counters for any other segments (including enclosing segments) are not 
affected. 


After the ORG directive is processed, any instruction or data bytes emitted 
in the current segment are placed at the location specified by expression. 


Example: 


; Set the loc. ctr. to be offset 100h into the segment. 
ORG 100h 


; Create an array which can be accessed two different 
* ways depending on which name is used. 
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barray DB 100 dup(?) 
ORG barray 
warray DW 50 dup(?) 


; Origin the location counter 10 bytes into barray. 
ORG barray+10 


Please see also: EVEN (3.11.2), ALIGN (3.11.3) 


3.11.2 EVEN Directive 


Syntax: 
EVEN 


The EVEN directive is used to force alignment on a word boundary of the 
next instruction or data byte generated. It does so by emitting a NOP 
instruction if the current value of the location counter is odd. If the 
location counter is even, this directive has no effect. 


The EVEN directive cannot be used on segments which have a BYTE 
align type because the assembler cannot know whether the segment is 


going to have an even or odd base address when 386! LINK combines it 
with other segments. 


Example: 


The following example demonstrates how to word align an array of 100 
words: 


EVEN 
warray DW 100 dup(?) 


This next example forces a NOP byte to be generated before the MOV 


instruction: 
cseg SEGMENT usel6 
ORG 100h 
sub ax,1000h 
EVEN 
mov bx,ax 
cseg ENDS 


Please see also: ORG (3.11.1), ALIGN (3.11.3) 
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3.11.3 ALIGN Directive 


Syntax: 


ALIGN expression 


The ALIGN directive is used to align the location counter of the currently 
open segment to the alignment boundary specified by expression. The 
expression is required to be a power of two, and an error is signaled if it is 
not. 


3861 ASM does not verify that the specified alignment value makes sense 
for the segment’s alignment type. It does not make sense to align the 
location counter for a segment to a value larger than the granularity of the 
segment’s align type, because the assembler does not know how the 
segment will be combined with other segments by 386! LINK. 


If the number of bytes needed to align the location counter on the 
specified boundary is less than four, 386! ASM uses NOP bytes to fill the 
space. If the number of bytes is four or more, 386!ASM simply adjusts the 
location counter, causing the space to be filled with zero bytes by 
386| LINK. This feature is useful for aligning instructions in a code 
segment on word or double word boundaries. 
Example: 

; Align the location counter on a double word boundary 


. 
’ 


ALIGN 4 


; Align the location counter on a paragraph boundary. 


ALIGN 16 


; Align the location counter on a page boundary. 
ALIGN 256 


Please see also: ORG (3.11.1), EVEN (3.11.2) 
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Defining Constants with the EQU 
and = Directives 


4.1 Introduction 


It is frequently desirable to substitute symbolic names for the constant 
values used during an assembly. They make code more readable and 
easier to support. 386! ASM supports three types of symbolic constants: 
integer values, aliases for assembler keywords, and strings of arbitrary text. 


Symbolic constants are defined using the EQU and equal sign (=) 
directives. The EQU and equal sign directives can also be used to define 
variables and labels (please see section 5.2.3 and section 6.5.3 for details). 


4.2 EQU Directive 


Syntax: 


name EQU expression 


The EQU directive is used to define all three types of constants: integer 
values, aliases, and text strings. The name parameter specifies the 
symbol’s name, which must be unique. The assembler replaces each 
subsequent occurrence of name with its constant value, whether it is an 
integer, an alias, or a string of text. 


Symbols defined with the EQU directive cannot be redefined. 


4.2.1 Using EQU to Create Absolute Constants 


Syntax: 


name EQU expression 


Defining Constants with the EQU and = Directives 


The assembler first attempts to evaluate the expression following the EQU 
directive as an integer expression. If it evaluates to an absolute constant, 
name is entered in the user-defined symbol table as an absolute constant 
symbol. An absolute constant is not relocatable, does not have a data type, 
and does not reference any undefined or forward defined symbols. If the 
expression is an address expression (relocatable), name is entered in the 
user-defined symbol table as a label or variable. Consult sections 5.2.3 and 
6.5.3 for details. 


An absolute constant symbol can be used anywhere an integer is valid in 
an expression. Its value can also be made available to other modules in a 
program using the PUBLIC directive. 


4.2.2 Creating Text Substitution Symbols 


Syntax: 


name EQU arbitrary text 


If the assembler is unable to successfully evaluate the remainder of the 
line which follows the EQU directive as an integer constant, it saves it as a 
text string instead. Each subsequent occurrence of name is replaced with 
the arbitrary text which follows its definition. This is a simple way of 
creating macros which have no parameters. 


Note that a text constant is evaluated by the assembler each time it is 
expanded. Thus, its value can change each time it is used if the value of 
one of the symbols in the string has changed. Care must be taken when 
defining and using text strings if a constant value is desired. 


4.2.3 Creating Aliases for Assembler Keywords 


Syntax: 


name EQU keyword 


An alias for an assembler keyword is actually a special case of a text 

substitution. If the arbitrary text which follows the EQU directive is a 
single assembler keyword, name is entered in the user-defined symbol 
table as a reference to the keyword instead of a text string. This form of 
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substitution requires less symbol table space and is expanded more quickly 
by the assembler. 


4.2.4 Examples with EQU 


Example: 


. 
’ 


; define some constants with EQU 


ei EQU 10h ; absolute constant = 16 
c2 EQU c1+10 ; absolute constant = 26 
t1 EQU word ptr ; tl is a text string 
argl EQU 8[ebp] ; argl is a text string 
t2 EQU c3+5 ; t2 is text because of 
; forward reference 

es EQU 10h*10h ; absolute constant = 256 
stk_frm EQU ebp ; alias for keyword EBP 


. 
, 


; use constants defined with EQU in instructions 


mov eax,cl ; load 16 into EAX 
mov ebx, c2 ; load 26 into EBX 
mov ecx,argl ; load 8[ebp] into ECX 
mov edx,t2 ; load 261 into EDX 
mov esi,c3 ; load 256 into ESI 
push stk_frm ; set up 

mov stk_frm, esp ; stack frame 


Please see also: = (4.3), EQU (5.2.3), EQU (6.5.3), PUBLIC (7.2),-DEFINE 
(2.2.7) 


4.3 The = (Equal Sign) Directive 


Syntax: 


name = expression 


The equal sign directive is used to create constants in much the same way 
as the EQU directive, with the restriction that it cannot create text 
substitution or alias symbols. 
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Absolute constants defined with the equal sign directive can be used in an 
expression anywhere an integer is valid. Their values can also be made 
available to other modules using the PUBLIC directive. 


The difference between constants defined with the EQU directive and 
constants defined with the equal sign directive is that constants defined 
with the equal sign directive can be redefined at any time by using their 
name with another equal sign directive. The assembler replaces each 
subsequent occurrence of name with its most recent value when the 
reference is encountered. 


Example: 
cl = 10h absolute constant = 16 
mov ax,cl load 16 into Ax 


cl = 20h ; absolute constant = 32 
mov bx, cl ; load 32 into BX 


Please see also: EQU (4.2), = (5.2.3), = (6.5.3), PUBLIC (7.2) 
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Instruction Labels, Control 
Transfer, and Procedure Blocks 


5.1 Introduction 


Most control transfer instructions in the 80386 instruction set require an 
instruction label as their operand. An instruction label is a user-defined 
symbol which has an address and a data type. Its address has two 
attributes: a segment and an offset. The segment attribute is the segment 
in which the label resides, and the offset attribute is the location of the 
label within its segment. A label’s data type must be either NEAR or FAR 
and specifies how the assembler expects control to be transferred to it. The 
assembler uses this information to generate the correct instruction opcode 
for CALLs or JMPs to a label, and for a RET within a procedure. A NEAR 
label is reached with an intra-segment transfer, while a FAR label is 
reached with an inter-segment transfer. Some control transfer 
instructions only support intra-segment transfers; consult Appendix D for 
the valid address modes for a specific instruction. If you are not familiar 
with the NEAR and FAR control transfers dictated by the segmented 
architecture of the 8086 processor family, read Chapter 11 before reading 
this chapter. 


Instruction labels and procedure names may be made globally accessible 
with the PUBLIC and EXTRN directives. 


5.2. Instruction Labels 


There are several ways to create instruction labels in the user-defined 
symbol table. Each method is described in detail below. 
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5.2.1 Creating a Label with : (Colon) 


Syntax: 


labelname: 


The simplest way to create an instruction label is to follow the label name 
with a colon (:). This creates a label named labelname which has a data 
type of NEAR, a segment attribute of the currently open segment, and an 
offset attribute equal to the current value of the location counter. The 
label name must be the first thing that appears on the source line, and it 
must be unique. 


There is no way to create a label with a data type of FAR using: . 


Example: 


The example below shows how control can be transferred to one of two 
NEAR labels depending on whether the accumulator contains the value 


4: 
cmp eax, 4 
je equal4 
jmp nequal4 
equal4: 
nequal4: 


Please see also: PUBLIC (7.2) 


5.2.2 Creating a Label Using the LABEL Directive 


Syntax: 


labelname LABEL type 


The LABEL directive creates a label named labelname in the user-defined 
symbol table. The type parameter specifies the label’s data type and may be 
either NEAR or FAR. Like labels created with :, a label created with the 
LABEL directive has a segment attribute of the currently open segment 
and an offset attribute equal to the current value of the location counter. 
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Example: 


The following example demonstrates how to define two entry points to 
the same routine, with one having a data type of NEAR, and the other 
having a data type of FAR: 


nearentry LABEL near ; Near entry point 
farentry LABEL far ; Far entry point 
mov eax,5 ; Subroutine begins here 


Please see also: LABEL (6.5.2), PUBLIC (7.2) 


The LABEL directive can also be used to create variables. A description of 
the syntax appears in section 6.5.2. 


5.2.3 Creating a Label Using the EQU and Equal Sign Directives 


Syntax: 


labelname EQU address expression 
labelname = address expression 


If the expression which follows an EQU or an equal sign directive 
evaluates to a relocatable quantity having a data type of NEAR or FAR, 
386! ASM enters the symbol in the symbol table as a label instead of a 
constant. Using this method, it is possible to create a label with arbitrary 
segment and offset attributes. The address expression can be any expression 
which evaluates to a relocatable quantity having a data type of NEAR or 
FAR. The new label has a segment attribute equal to the segment attribute 
of the expression and an offset attribute equal to the expression’s value. 


Example: 
Each of the following examples use the EQU directive to create instruction 
labels: 

csegl SEGMENT word public 'code' 

11 LABEL far 


csegl ENDS 
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cseg2 SEGMENT word public 'code' 


labl EQU $ ; $ has a data type of AR 
lab2 EQU $+5 ; 5 bytes past the loc. r. 
lab3: 


: A far label at the same address as lab3. 
lab4 EQU far ptr lab3 

: A far label 7 bytes past lab4 

lab5 EQU lab4+7 

; A near label at the current loc. ctr. 

lab6é EQU THIS near 

: A far label in segment csegl 4 bytes past 11 
lab7 EQU 11+4 

cseg2 ENDS 


Please see also: EQU (4.2), EQU (6.5.3), = (4.3), = (6.5.3), PUBLIC (7.2), $ 
(9.2.2), THIS (9.3.13) 


The EQU and equal sign directives can also be used to create variables. If 
the address expression following the directive has the data type of a 
variable, a variable is created. Please see section 6.5.3 for details. 


5.2.4 Control Transfers to Address Expressions 


Control transfer instructions normally require an instruction label as their 
operand. However, it is permissible to use an address expression with 
data type NEAR or FAR. (Some instructions only permit a data type of 
NEAR.) Thus, it is possible to transfer control to the location specified by 
any address expression without creating a label located at the destination. 


While this practice is discouraged for reasons of style, there may be cases 
where such expressions are useful. 


Example: 
csegl SEGMENT word public 'code' 
labl EQU $ 
7 a very simple address expression 
jmp labl 
* S bytes past labl 
jmp lab1+5 
56 
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; a far jump to a near label 


jmp far ptr nearlab 
csegl ENDS 
cseg2 SEGMENT word public ‘code! 
nearlab LABEL near 
cseg2 ENDS 


5.2.5 Control Transfers Using Indirection 


The CALL and JMP instructions also allow a variable as their operand. 
When the assembler sees a CALL or JMP instruction with a variable as its 
operand, it generates an indirect form of the instruction. When the 
instruction is executed, control is transferred to the location pointed to by 
the variable. The type of transfer generated (NEAR or FAR) depends on 
the data type of the variable and the use type of the currently open 
segment. In most cases, a variable of the same size as the use attribute of 
the currently open segment generates a NEAR transfer, and a variable two 
bytes larger generates a FAR transfer. There are exceptions to this rule due 
to certain ambiguities; consult Appendix J for a full explanation. 


Example: 


Assuming we are assembling instructions for an 8086 target, the following 
instructions generate indirect control transfers: 


labell LABEL near 


nptr DW labell 
fptr DD labell 
call nptr ; Near transfer (16-bit ptr) 
call bx ; Near transfer (16-bit reg) 
call fptr ; Far transfer (32-bit ptr) 


And if we are in a USE32 segment, assembling instructions for an 80386 
target: 


label2 LABEL near 


nptr DD label2 
fptr DF label2 
call nptr ; Near transfer (32-bit ptr) 
call ebx ; Near transfer (32-bit reg) 
call fptr ; Far transfer (48-bit ptr) 
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5.3 Procedure Blocks 


Procedure blocks are used to split a program into logical sections. 
Typically, each subroutine in a program is given its own procedure block. 
The name of the subroutine is given to the procedure block. The name of 
a procedure block has the same attributes as a label and can be used any 
place an instruction label is valid in an expression. 


A procedure block definition is started with the PROC directive and is 
terminated with the ENDP directive. Normally, a procedure will contain 
at least one RET instruction to return control to the caller. The assembler 
generates the form (NEAR or FAR) of the RET instruction that 
corresponds to the data type of the procedure. 


A procedure block can also contain an arbitrary number of locally defined 
symbols. A locally defined symbol is only visible inside the procedure 
block in which it is defined, thus permitting local symbols to have the 
same names in different procedure blocks. 


5.3.1 PROC Directive 


Syntax: 


Procname PROC {type} 


The PROC directive marks the beginning of a procedure block. The 
procname parameter specifies the name of the procedure, which must be 
unique. The optional type parameter specifies the type of the procedure, 
which must be either NEAR or FAR. If no procedure type is specified, a 
default type of NEAR is used. A procedure’s address can be made 
available to other modules in a program with the PUBLIC directive. 


Nesting of procedure definitions is permitted, but the nesting must be 
strictly block structured. In other words, the definitions cannot overlap. 


Example: 


The example below demonstrates a procedure which loads the number 5 
into the AX register and returns to its caller: 
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load5 PROC near 


mov ax,5 
ret 


load5 ENDP 


This example demonstrates a procedure correctly nested inside another 


procedure: 
outer PROC near ; Start of outer procedure 
inner PROC near ; Start of nested procedure 
inner ENDP ; End of nested procedure 
outer ENDP ; End of outer procedure 


Finally, an example of incorrectly nested procedures: 


outer PROC near ; Start of outer procedure 
inner PROC near ; Start of nested procedure 
outer ENDP ; ERROR - outer ends before 
inner ENDP ; ERROR 


Please see also: ENDP (5.3.2), PUBLIC (7.2) 


5.3.2  ENDP Directive 


Syntax: 


procname ENDP 


The ENDP directive terminates the definition of a procedure block. The 
procname parameter specifies the name of the procedure to be closed, 
which must be the name of the most recently opened procedure. If 
procname is not the name of the most recently opened procedure, an error 
is signaled and the most recently opened procedure is then closed. 
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It is permissible to close a segment without closing a currently open 
procedure. However, the segment must be reopened and the procedure 
block closed before the end of the source file. It is illegal to close a 
procedure in a different segment from the one in which it was opened. 


Please see also: PROC (5.3.1) 


5.3.3. Local Symbol Definitions Within Procedure Blocks 


When inside a procedure block, all variable, label, and constant 
definitions which use the pound character (#) as the first character of the 
symbol’s name are processed as local symbol definitions. A local symbol 
definition is only visible inside the procedure in which it is defined, and 
the symbol name need only be unique to that procedure. It is not visible 
to any enclosing procedures, nor is it visible to any procedures nested 
inside the procedure being defined. The syntax of a local symbol 
definition is the same as that of a normal symbol definition, except that 
the name of the symbol being defined must start with the # character. 


Local symbols are a convenient way to create temporary labels and 
variables without having to give each one a unique name. Such symbols 
are useful as labels for conditional jumps, temporary variables, and offsets 
of function parameters in the runtime stack. 


Note that a local symbol takes up the same amount of space in the symbol 
table as a normal symbol. Its definition remains in the symbol table even 
after the enclosing procedure is terminated; it just becomes invisible. 


Local symbols cannot be external, nor can their values be made available 
to other modules with the PUBLIC directive. 


Example: 


The following example demonstrates the use of local symbols within a 
procedure block. It creates and uses a local constant, a label, and a variable. 


Pprocl PROC near 
#argl = 6 


mov eax, #argl [esp] 
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or eax, eax 
jnz #11 
ret 

wL1: 
mov CS: #templ,eax 
ret 


#templ DD 0 
procl ENDP 


Please see also: Labels (5.2), Variables (6.5), Defining Constants With the 
EQU and = Directives (Chapter 4), Symbol Formation 
(3.2.2) 
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Chapter 6 


Variables and Data Declarations 


Introduction 


The data declaration directives are used to create and optionally initialize 
blocks of memory in a segment. In addition to providing directives which 
initialize any of the assembler-defined data types, 386 | ASM also allows 
the programmer to define and initialize arbitrary data structures. The 
assembler—defined data types are initialized using the DB, DW, DD, DF, 
DP, DQ, and DT directives, and user-defined data types can be created 
using the STRUC and RECORD directives. Variables may be made 
globally accessible with the PUBLIC and EXTRN directives. 


The data declaration directives are also used to create variables. Like an 
instruction label, a variable is a user-defined symbol which has an address 
and a data type. Its address has two components: a segment attribute and 
an offset. The segment attribute is the segment in which the variable 
resides, and the offset attribute is the location of the variable within its 
segment. A variable’s data type is either one of the assembler—defined 
data types or the name of a user-defined structure or record. 


The assembler usually must know the data type of instruction operands in 
order to choose the correct form of the instruction. Ifa variable is used in 
an expression for an operand, the operand is given the data type of the 
variable. This default can be overridden if necessary by using the PTR 
operator. 


6.2. Data Declaration Directives 


The following sections describe the data declaration directives for the 
assembler-defined data types in more detail. The same syntax is used for 
all the data declaration directives, however, each directive allows a 
slightly different set of values in its initializer list. 
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6.2.1 DB Directive 


Syntax: 


{name} DB value,... 


The DB directive is used to initialize one or more bytes in the currently 
open segment from the list of values which follows the directive on the 
line. If the optional name is specified, a variable of type BYTE is created in 
the user-defined symbol table. It will have a segment attribute of the 
currently open segment and an offset equal to the current value of the 
location counter. 


The value parameter is an expression which evaluates to an integer, a 
string constant, or the undefined storage operand (?). If the value is an 
integer, one byte is allocated and initialized to the value of the expression. 
If the value is the undefined storage operand, a byte is allocated but not 
given an initial value. If the value is a string constant, one byte is 
allocated and initialized for each character in the string. Relocatable 
values are permitted with the DB directive, though it is likely that a fixup 
overflow will occur when 386! LINK attempts to resolve the relocatable 
reference and to fit it into a byte. 


If there is more than one value on the line following the directive, each 
value must be separated by a comma. 386! ASM then allocates and 
initializes as many bytes as necessary to process it. 


Example: 


factor DB 10h 
astring DB 'This is an ASCII string! 
DB 'A NULL terminated string',0 
intexpr DB 12+4*4 
listval DB 1,2,3,4,5 
unknown DB ? 


Please see also: DUP (6.3), Undefined Storage Operand (?) (6.4), PUBLIC 
(7.2), String Constants (3.2.3.4) 
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6.2.2 DW directive 


Syntax: 


{name} DW value,... 


The DW directive is used to initialize one or more words (a word is two 
bytes) in the currently open segment from the list of values which follows 
the directive on the line. If the optional name is specified, a variable of 
type WORD is created in the user-defined symbol table. It will have a 
segment attribute of the currently open segment and an offset equal to the 
current value of the location counter. 


The value parameter is an expression which evaluates to an integer, a one- 
or two-character string constant, or the undefined storage operand (?). If 
the value is an integer or a character string constant, one word is allocated 
and initialized to the value of the expression. If the value is the 
undefined storage operand, a word is allocated but not given an initial 
value. Relocatable values are permitted with the DW directive, though it 
is possible that a fixup overflow will occur when 3861 LINK attempts to 
resolve the relocatable reference. 


If there is more than one value on the line following the directive, each 
value must be separated by a comma and each will allocate and initialize 
its own word of memory. 


Example: 


factor DW 1000h 
charl DW ‘'A' 
char2 DW ‘'AB' 

DW 12+4*4 
listval DW 1,2,3,4,5 
relval DW OFFSET factor 
unknown DW ? 


Please see also: DUP (6.3), Undefined Storage Operand (?) (6.4), PUBLIC 
(7.2) 
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6.2.3 DD Directive 


Syntax: 


{name} DD value,... 


The DD directive is used to initialize one or more double words (a double 
word is four bytes) in the currently open segment from the list of values 
which follows the directive on the line. If the optional name is specified, a 
variable of type DWORD is created in the user-defined symbol table. It has 
a segment attribute of the currently open segment and an offset equal to 
the current value of the location counter. 


The value parameter is an expression which evaluates to an integer, a 
character string constant from one to four characters in length, a four-byte 
real number, a four-byte encoded real number, or the undefined storage 
operand (?). If the value is an integer or a character string constant, a 
double word is allocated and initialized to the value of the expression. If 
the value is the undefined storage operand, a double word is allocated but 
not given an initial value. Ifthe value is a real number, four bytes are 
allocated and the value is stored as an 80287 format short real. 


If value is relocatable, 386 | ASM outputs different object code depending on 
the target CPU of the assembly. If the target CPU is an 80386, the 
relocatable expression is output as a 32 bit offset which will be resolved by 
the linker. If the target CPU is an 8086, 80186, or 80286, a relocatable value 
is output as a 16 bit offset followed by a 16 bit segment selector. These 
values will be resolved by the linker to the offset portion of the value 
expression followed by the segment portion of the value expression. 


If there is more than one value on the line following the directive, each 
value must be separated by a comma, and each will allocate and initialize 
its own double word of memory. 


Example: 


factor DD 10000h 
charl DD: *A* 
char2 DD ‘ABCD! 

DD 10000h*10h+07Fh 
encreal DD 3F800000r ;1.0 
realval DD 1.0E-10 


386IASM Reference Manual 


Variables and Data Declarations 


listval DD 1,2,3.14159,4,5 
relocl DD factor 

reloc2 DD OFFSET factor 
unknown DD ? 


Please see also: DUP (6.3), Undefined Storage Operand (?) (6.4), PUBLIC 
(7.2) 


6.2.4 DF and DP Directives 


Syntax: 


{name} DF value,... 
{name} DP value,... 


The DF and DP directives (which are synonyms and can be used 
interchangeably) are used to initialize one or more 48 bit pointer words in 
the currently open segment from the list of values which follows the 
directive on the line. If the optional name is specified, a variable of type 
PWORD is created in the user-defined symbol table. It will have a 
segment attribute of the currently open segment and an offset equal to the 
current value of the location counter. 


The value parameter can be a six-byte integer, a character string constant 
from one to six characters in length, a relocatable quantity, or the 
undefined storage operand. If the value is a six-byte integer or string 
constant, six bytes are allocated and initialized to the value specified. If it 
is the undefined storage operand, six bytes are allocated but not initialized. 


If the value is a relocatable quantity, it is output as a 32 bit offset followed 
by a 16 bit segment selector. These values will be resolved by 386! LINK to 
the offset portion of the relocatable expression followed by the segment 
portion of the expression. 


If there is more than one value on the line following the directive, each 
value must be separated by a comma, and each will allocate and initialize 
its own six byte piece of memory. 


The DF and DP directives are only available if the 80386 is the target CPU 
of the assembly. 
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Example: 


sixbyte DP 123456789ABCh 
charl bP ‘A’ 
DP 'ABCDEF' 
relocl DF sixbyte 
listval DF 1,2,charl1,4,5,sixexpr 
unknown DF ? 


Please see also: DUP (6.3), Undefined Storage Operand (?) (6.4), PUBLIC 
(7.2) 


6.2.5 DQ Directive 


Syntax: 


{name} DQ value,... 


The DQ directive is used to initialize one or more quad words (a quad 
word is eight bytes) in the currently open segment from the list of values 
which follows the directive on the line. If the optional name is specified, a 
variable of type QWORD is created in the user-defined symbol table. It 
will have a segment attribute of the currently open segment and an offset 
equal to the current value of the location counter. 


The value parameter can be an eight byte integer, a character string 
constant from one to eight characters in length, an eight byte real number, 
an eight byte encoded real number, or the undefined storage operand (?). 
If the value is an integer or a character string constant, a quad word is 
allocated and initialized to the value specified. If the value is the 
undefined storage operand, a quad word is allocated but not given an 
initial value. If the value parameter is a real number, eight bytes are 
allocated, and the value is stored as an 80287 format long real. 


If there is more than one value on the line following the directive, each 


value must be separated by a comma, and each will allocate and initialize 
its own quad word of memory. 


Example: 
quadint DQ 123456789ABCDEFOh 


charl DO: -*A* 
char2 DQ 'ABCDEFGH! 
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realval DQ 1.0E200 

encreal DQ 3FF0000000000000r ;1.0 
DO 1,2; 3.14155, 4,5 

unknown DQ ? 


Please see also: DUP (6.3), Undefined Storage Operand (?) (6.4), PUBLIC 
(7.2) 


6.2.6 DT Directive 


Syntax: 


{name} DT value,... 


The DT directive is used to initialize one or more ten byte chunks of 
memory in the currently open segment from the list of values which 
follows the directive on the line. If the optional name is specified, a 
variable of type TBYTE is created in the user-defined symbol table. It will 
have a segment attribute of the currently open segment and an offset 
equal to the current value of the location counter. 


The value parameter can be a ten byte integer, a character string constant 
from one to four characters in length, a ten byte real number, a ten byte 
encoded real number, a ten byte packed decimal number, or the undefined 
storage operand (?). If the value is an integer or a character string 
constant, ten bytes are allocated and initialized to the value specified. If 
the value is the undefined storage operator, ten bytes are allocated but not 
initialized. If the value is a real number, ten bytes are allocated, and the 
value is stored as an 80287 format temporary real. Lastly, if the current 
default radix is base 10 and there is no radix specifier at the end of the 
value, it is stored as a ten byte 80287 packed decimal number. 


If there is more than one value on the line following the directive, each 
value must be separated by a comma, and each will allocate and initialize 
its own ten byte piece of memory. 


Note that the DT directive assumes that a constant which is composed 

entirely of decimal digits is a packed decimal number when the default 
radix is base 10. If you wish to use the DT directive to define a ten-byte 

integer value, you must follow the digits with the “D” radix specifier to 
indicate that it is an integer composed of decimal digits. 
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Example: 
tbyteint DT 123456789ABCDEF01234h 
charl DT *A* 
DT 'ABCD' 


realval DT 1.0E1000 

encreal DT 3FFF8000000000000000r ;1.0 
packdec DT 12345678901234567890 
listval DT 1,2,3.14159,4,5 

unknown DT ? 


Please see also: DUP (6.3), Undefined Storage Operand (?) (6.4), PUBLIC 


(7.2) 
6.3 DUP Operator 
Syntax: 
count DUP (value,...) 


The DUP operator is a special purpose operator which is used to create 
multiple instances of a given initial value or list of values. The count 
parameter specifies how many instances of the value list should be 
created. It can be any expression which evaluates to an absolute integer 
value. Forward references to symbols are illegal in the expression. 


The value parameter (or list of parameters) must be enclosed by 
parentheses and can be any valid expression or another DUP operator. If 
more than one value is specified, each element in the list must be 


separated by a comma. The maximum permitted nesting level of DUP 
operators is 17. 


Example: 


The following examples demonstrate the use of the DUP operator with 
the data declaration directives to initialize multiple copies of values: 


DB 500 DUP (?) 
length equ 1000h 
warray DW length DUP (0) 
stack DB 1024 DUP('STCK') 
alist DD 100 DUP(1,2,3,4) 
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nestl DT 10 DUP(5 DUP(1.0)) 
nest2 DB 5 DUP(1,2 DUP(?)) 


Please see also: Undefined Storage Operand (?) (6.4) 


6.4 Undefined Storage Operand (?) 


The undefined storage operand, denoted by “(?)”, is used to indicate to the 
assembler that the value a location has at assembly time does not matter, 
so no initial value is specified for it. It can be used as a value for any of 
the data declaration directives, but cannot be combined with other values 
in an expression. 


The undefined storage operand is most often used with the DUP operator 
to allocate large pieces of memory without initializing them to a value. 


Example: 
DB ? ; an undefined byte value 
BD 1,2,7;4.5 ; an undefined double word in an array 
DW 500 DUP(?) ; an array of 500 uninitialized words. 


Please see also: DUP (6.3) 


6.5 Creating Variables 


A variable is a user-defined symbol which has an address attribute and a 
data type. A variable is not required to occupy any space; thus two 
variables can reference the same block of memory. This section describes 
the different ways to create variables which have an assembler-defined 
data type. The method for creating variables with a user-defined data type 
is described in sections 6.6-6.11, which cover structure and record 
declarations. 


6.5.1 Creating a Variable with a Data Declaration Directive 
Each of the data declaration directives can create a variable by preceding 


the directive with the name of the variable. This is a simple way to create 
a variable which requires that space be allocated for it. Variables created 
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with the data declaration directives have a segment attribute of the 
currently open segment and an offset attribute equal to the value of the 
location counter at the time the directive is processed. 


Example: 


The following examples demonstrate how to create variables using the 
data declaration directives. The examples use simple values for the value 
list which follows the directive. A complete description of allowable 
values appears in the section describing each directive. 


bytevar DB ? ; An undefined byte value. 
wordvar DW 14+15 ; A word with value 29. 
dwordvar DD 1.4 ; A dword variable with 

; a short real value. 
tbytelst DT 1,2,3,4,5 ; A list of 5 tbyte 
; values. 


bytearr DB 1024 DUP(?) ; A 1024 byte array. 


Please see also: DUP (6.3), Undefined Storage Operand (?) (6.4), PUBLIC 
(7.2) 


6.5.2 Creating a Variable with the LABEL Directive 


Syntax: 


name LABEL type 


The LABEL directive can also be used to create variables using the syntax 
shown above. The name parameter is the name of the variable to be 
created and the type parameter is any of the assembler-defined data types. 
Variables created with the LABEL directive have a segment attribute of 
the currently open segment and an offset attribute equal to the value of 
the location counter when the directive is processed. 


The location counter is not changed when the LABEL directive is 
processed, so variables defined with it occupy no space. The LABEL 
directive is a convenient way to create two variables which can be used to 
address the same block of memory in different ways. 
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Example: 
varl LABEL word ; A word variable. 
var2 LABEL dword ; A double word variable. 


; An array which can be accessed as a byte or word 
; array depending on which name is used. 


barray LABEL byte 
warray DW 512 DUP(?) 


Please see also: LABEL (5.2.2), PUBLIC (7.2) 


6.5.3 Creating a Variable with the EQU and Equal Sign (=) Directives 


Syntax: 


name EQU address expression 
name = address expression 


If the expression which follows an EQU or equal sign (=) directive 
evaluates to a relocatable quantity having one of the assembler-defined 
data types, 386! ASM enters the symbol in the symbol table as a variable 
instead of a constant. Using this method, it is possible to create a variable 
with arbitrary segment and offset attributes. The name parameter is the 
name the variable has, which must be unique. The address expression can 
be any expression which evaluates to a relocatable quantity and has an 
assembler-defined data type. The variable has a segment attribute equal 
to the segment attribute of the expression. 


Example: 


The following examples use the EQU and = directives to create variables: 


varl EQU word ptr $ ; A word at the loc. ctr. 
var2 EQU byte ptr varl ; A byte at the same 
; address as varl. 
foo DB 5 
var3 EQU foot5 ; A byte 5 past foo. 
var4 = THIS adword ; A dword at the loc. ctr. 


Please see also: EQU (4.2), EQU (5.2.3), = (4.3), = (6.2.3), PUBLIC (7.2), 
(9.2.2), THIS (9.3.13) 
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The EQU and equal sign (=) directives can also be used to create 
instruction labels. If the address expression following the directive has a 
data type of NEAR or FAR, an instruction label is created. Please see 
section 5.2.3 for details. 


6.5.4 Referencing Variables 


Variable data types are used by the assembler to determine the size 
(number of bytes) of an instruction operand and to detect incompatible 
data type references. If necessary, the PTR operator can be used to override 
a variable’s data type in an expression. 


Example: 

wvar LABEL word 

dvar DD 0 
mov wvar,1 ; move a word value 
mov word PTR dvar,l ; move a word value 
pop dvar ; pop a double word 
mov wvar,ax ; valid statement 
mov dword PTR wvar,eax ; valid 
mov wvar,eax ; error 


Please see also: PTR (9.3.7) 


6.6 Structure Definitions 


386 | ASM allows the programmer to define arbitrary data structures and to 
assign them a name. An arbitrary data structure is a collection of one or 
more fields, each having an assembler-defined data type. When creating 
variables and initializing data, it is possible to use the name of a structure 
in place of an assembler data declaration directive. Thus, one can create 
and initialize variables which are instances of arbitrary structures. 
Structure fields can also have default values associated with them. These 
values are used when an instance of a structure is declared and no other 
value is given at declaration time. 


The remainder of this section is devoted to an explanation of the 


procedure for creating an arbitrary structure definition. Note that a 
structure definition does not itself allocate any memory. It only creates a 
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template for a structure and saves the default values for the fields. In 
order to allocate memory for a structure, use a structure declaration. 
Structure declarations are discussed later in this chapter. 


6.6.1 STRUC Directive 


Syntax: 


name STRUC 


The STRUC directive marks the beginning of a structure definition. The 
name parameter specifies the name of the structure to be created, which 
must be unique. The structure definition is terminated by the ENDS 
directive, and all lines between the STRUC and ENDS directives are 
processed as part of the structure definition. Since structure definitions do 
not allocate memory, they can be placed outside a segment block, if 
desired. 


6.6.2 ENDS Directive 


Syntax: 


name ENDS 


The ENDS directive terminates the current structure definition. The 
name parameter must be the same as the name used to start the structure 
definition. The ENDS directive causes the assembler to end the current 
structure definition and then to switch back to normal statement 
processing mode. 


Note that the ENDS directive is also used to close an open segment (please 


see section 3.8). The assembler determines which form of ENDS is 
intended based on whether or not a structure is currently being defined. 


Please see also: ENDS (3.8) 
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6.6.3 Defining Fields Within a Structure 


Syntax: 


{fieldname} DB value,... 
{fieldname} DW value,... 
{fieldname} DD value,... 
{fieldname} DP value,... 
{fieldname} DF value,... 
{fieldname} DQ value,... 
{fieldname} DT value,... 


Once a structure definition is started, all statements preceding the 
terminating ENDS directive must be either comments or data declaration 
directives. A data declaration directive within a structure defines a 
structure field (with an optional name) having the data type of the 
directive and a size equal to the amount of memory the directive 
allocates. The value list which follows the directive is saved as a default 
value for the field when an instance of the structure is declared. 


Thus a typical structure definition looks something like this: 


name STRUC 
*; definitions for the structure fields go here. 
name ENDS 
Example: 


A structure which could be a node in a balanced binary tree: 


node STRUC 


key DB 31 DUP(?) ; The key for the node 

balance DB ? ; The node's balance factor 
lchild DD? ; A pointer to the left child 
rchild DD? ; A pointer to the right child 


node ENDS 


A structure which has unnamed fields and initial values: 


pi STRUC 
sname BS *Pi*,6 * Structure's ID 
DB 0 * Pad byte for alignment 
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value DQ 3.1415926 ; Initial Value 


pi ENDS 
6.7. Structure Declarations 


As mentioned above, a structure definition creates only a template for 
data. In order to allocate and initialize memory for a structure, use a 
structure declaration. This section discusses how to allocate and initialize 
one or more instances of a structure and how to create structure variables. 


6.7.1 Using a Structure Name to Allocate Memory 


Syntax: 


{name} structurename <{value,...}> 


Once a structure has been defined, its name can be used in a similar 
manner to the data declaration directives for assembler—defined data 
types. Using a structure name in this manner causes the assembler to 
allocate space for an instance of the structure in the currently open 
segment. 


The name parameter is optional and, if present, it creates a variable with a 
symbol type of structure and an address attribute of the current value of 
the location counter. The structurename parameter is the name of a 
structure previously defined with the STRUC directive. The angle 
brackets which follow the structurename parameter must be present and 
are used to contain an optional list of values used in place of the 
structure’s default field values or initializers. One value per field is 
permitted in the structure being initialized. Multiple values must be 
separated with commas. If an initializer for a field is omitted, the default 
field value is used. 


aE 


6.7.2 Initializers 


3861 ASM restricts the types of structure fields which can be initialized. 
Only structure fields which are a single value or a constant string can 
have their default values overridden by an initializer. Any field which 
contains a list of values, or multiple values allocated with DUP, cannot be 
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initialized when an instance of a structure is allocated. A constant string’s 
value can be replaced by any number of bytes up to its length. If the 
initializer is smaller than the string it is replacing, the trailing bytes of the 
field are padded out with spaces (20h). 


6.7.3 Creating Multiple Structures with the DUP Operator 


Syntax: 


{name} structurename count DUP (<{value,...}>) 


It is possible to use the DUP operator to create multiple instances of a 
structure with each one using the same set of initial values. The syntax of 
such a declaration is similar to that used for the data declaration 
directives. The count parameter tells 386!|ASM how many instances of the 
structure to create, and the optional initializer list appears inside the 
parentheses which follow the DUP operator. The allowable values for the 
initializer list are the same as if the DUP operator were not used. 


Example: 


Some examples of structure definitions and declarations appear below: 


node STRUC 


key DB 31 DUP(?) 
balance DB 0 
lchild DD ? 
rchild DD ? 


Cannot be initialized 
Can be initialized 
Can be initialized 
Can be initialized 


 7e Se Me Fe 


node ENDS 


; create a node using the structure's default values 
nodel node <> 


; Create a node and set the balance factor to 0. 
node2 node <,0> 


*; Create a node and set the balance factor to 0 and 
; the child pointers to two other nodes. 
node3 node <,0,nodel,node2> 


; Create 20 nodes with a balance factor of 0 and 
* NULL child pointers. 


nodearray node 20 DUP (<,0,0,0>) 
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STRUC 

DB 'PISTRUCT' ; Can be initialized 
DB 0 ; Can be initialized 
DQ 3.1415926 ; Can be initialized 
DB 1,2,3,4 ; Cannot be initialized 
ENDS 


; Create 


an instance using the default field values. 
create a variable. 
pi <> 


an instance and override the structure's name 


; and value fields. 


newpi 


; Create 


pi <'NEWPI',,3.1748> 


an array of 10 instances of the structure 


; with no name and all fields zero except the last one 
; which uses the default. 


piarray 


pi 10 DUP(<' ',0,0.0>) 


Please see also: DUP (6.3), Undefined Storage Operand (?) (6.4), STRUC 


(6.6.1) 


6.8 Referencing Structures 


Structure variables carry an address (segment and offset) attribute, but do 
not have a data type. Individual fields in a structure are most easily 
referenced with the structure field operator (please see section 9.3.9). The 
data type of the expression is obtained from the field data type. The 
structure field operator adds the field offset within the structure to the 
structure address to obtain the correct address of the structure field. 


Example: 


farp 
offs 
segsel 
farp 
dseg 


STRUC 

DD ? ; offset in segment 
DW ? ; segment selector 
ENDS 


SEGMENT word public 
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ptrarray farp 10 DUP (<0,dseg>) 

dseg ENDS 

cseg SEGMENT word public 
mov ax, ptrarray.segsel ; load 1st ptr 
mov es, ax ; in array into 
mov edi,ptrarray.offs ; ES:EDI 
mov _ @bx,OFFSET ptrarray ; load ptr to 2nd 
add ebx, SIZE farp ; struc in array 
mov ax, [ebx] .segsel ; load 2nd ptr 
mov fs,ax ; in array into 
mov esi, [ebx] .offs ; FS:ESI 

cseg ENDS 


Please see also: SIZE (9.3.4), Structure Field Operator (9.3.9) 


6.9 RECORD Directive 


Syntax: 


name RECORD fname:width{=expr},... 


The RECORD directive allows the programmer to break up an 8-, 16-, or 32 
bit value into named sub-fields, each one having an arbitrary width in 
bits. It is also possible to give each bit field an initial value to be used as a 
default when an instance of the record is created. 


The name parameter assigns a name to the record being defined, which 
must be unique. Each field definition must have its field name and field 
width separated by a colon. If the optional default field value is specified, 
it must immediately follow the field width and be preceded by an equal 
sign. Multiple field definitions must be separated with commas. 


Default field values are specified by an expression which must evaluate to 
a constant value small enough to fit in the specified field width. If no 
default value is specified, the field is given a default value of zero. 
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Fields in a record are allocated left to right, with the first field following 
the directive using the leftmost bits in the record. Succeeding fields are 
also allocated left to right in the remaining bits of the record. 


3861 ASM processes record definitions using the following logic: 


1. The total size in bits of all the fields in the record is calculated, and a size for the 
record is chosen. A record can be 8, 16, or 32 bits wide (32 bit wide records 
are permitted only if the target CPU is an 80386). The assembler chooses the 
smallest size in which the entire record fits. 


2. Next, the bit offsets for the fields are chosen. As mentioned above, the fields in 
a record are allocated left to right in the order in which they follow the 
RECORD directive. If the total size of the fields does not completely fill the 
record, the fields are shifted to the right to guarantee that the last bit of the 
last field occupies bit zero of the record. Unused high order bits are set to 
zero. 


Note that a record definition does not itself allocate any memory. It only 
creates a template for a record and saves the default values for the fields. 
In order to allocate memory for a record, use a record declaration. Record 
declarations are discussed in the next section. Since record definitions do 
not allocate memory, they can be placed outside a segment block, if 
desired. 


Example: 


Each example below shows a RECORD directive and how the fields of the 
record it creates are organized in memory. The default values for the 
fields are also shown in the memory layout. 


; An eight bit record with two four bit fields. 


recl RECORD fieldl:4,field2:4 


Bit Number 7 4 3 0 


Field Name Field 1 Field 2 
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> A 16 bit record which only uses nine bits. The 
: middle field has a default value of three. 


rec2 RECORD hibits:3,midbits:3=3,lobits:3 


BitNumber 15 8 7 0 
00 | ort | oo 
Field Name hibits midbits lobits 


; A 32 bit record which is made up of three one byte 
; fields having default values of A, B, and C. 


rec3 RECORD chl:8='A',ch2:8='B',ch3:8='C! 


Bit Number 31 24 23 16 15 8 7 0 


Field Name chl ch2 ch3 


6.10 Record Declarations 


Like a structure definition, a record definition creates only a template for 
data. In order to allocate and initialize memory for a record, you must use 
a record declaration. This section discusses how to allocate and initialize 
one or more instances of a record and how to create record variables. 


6.10.1 Using a Record Name to Allocate Memory 


Syntax: 


{name} recordname <{value,...}> 


Once a record is defined, its name can be used in a manner similar to the 
data declaration directives for assembler-defined data types. Using a 
record name in this manner causes the assembler to allocate space for an 
instance of the record in the currently Open segment. The amount of 
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space allocated is one, two, or four bytes, depending on the total size of the 
fields in the record. 


The name parameter is optional and, if present, it creates a variable with a 
symbol type of record and an address attribute of the current value of the 
location counter. In addition, a record variable can be referenced as a 
variable of type BYTE, WORD, or DWORD, depending on whether the 
record size is one, two, or four bytes. The recordname parameter is the 
name of a record defined with the RECORD directive. The angle brackets 
which follow the recordname parameter must be present and are used to 
contain an optional list of values to be used in place of the record’s default 
field values. One value is permitted per field in the record being 
initialized. Multiple values must be separated with commas. If an 
initializer for a field is omitted, the default value given at definition time 
is used. 


An initializer for a record field must be an absolute value and must fit in 
the width of the field it is initializing. If the initializer is relocatable or too 
large for the field, an error is posted and the default value for the field is 
used instead. 


6.10.2 Creating Multiple Records with the DUP Operator 


Syntax: 


{name} recordname count DUP (<{value,...}>) 


It is possible to use the DUP operator to create multiple instances of a 
record, with each having the same set of initial values. The syntax of such 
a declaration is similar to that used for the data declaration directives. 

The count parameter tells 386! ASM how many instances of the record to 
create, and the optional initializer list appears inside the parentheses 
which follow the DUP operator. The allowable values for the initializer 
list are the same as if the DUP operator were not used. 


Example: 


recl RECORD fieldl1:4,field2:4 


; a one byte record using default values (in this 
; case, zero since no defaults were given). 
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P< 


bytel recl <> 


; a one byte record with the low nibble equal to 3. 
byte2 recl <,3> 


; a one byte record with value 12h 
byte4 recl <1,2> 


; ten one byte records with value 34h 
bytearray recl 10 DUP (<3, 4>) 


rec3 RECORD ch1:8='A',ch2:8='B',ch3:8='C' 


; a 32 bit record with value 00000043h. 
dwordl rec3 <0,0> 


; a 32 bit record with value 00123456h 
dword2 rec3 <10h+2,4*12+4,56h> 


Please see also: DUP (6.3), Undefined Storage Operand (?) (6.4), RECORD 
(6.9) 


6.11 Referencing Records 


Record variables carry an address (segment and offset) attribute, and can 
also be referenced as BYTE, WORD, or DWORD variables, depending on 
whether they are 8, 16, or 32 bits wide. The WIDTH operator can be used 
to obtain the width, in bits, of a record or record field. The MASK 
operator can be used to obtain a bit mask for the defined bits in the record, 


or for a single field in the record. The SIZE operator gives the size of the 
record in bytes (one, two, or four bytes). 


Example: 
flags RECORD inuse:1,type:4 
farray flags 10 DUP (<0,0>) 
flag2 PROC near 
mov al,farray+SIZE flags ; load 2nd 
; flag byte 
test al,MASK inuse ; call type 
jz #not_used ; check routine 
call type _ chk . 4f-in uge 
84 
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#not_used: 
ret 
flag2 ENDP 


Please see also: WIDTH (9.3.5), MASK (9.3.5), SIZE (9.3.4) 
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Global Symbol Definitions 


7.1 Introduction 


It is often necessary to break up a large program into several modules 
which are assembled separately. A problem which occurs when modules 
are separately assembled is that subroutines and data once accessible to the 
entire program are now accessible only inside the module in which they 
are defined. The global symbol management directives provide a solution 
to this problem by allowing variables, instruction labels, and absolute 
constants from one module to be referenced in the other modules of a 
program. 


The PUBLIC directive is used to make available the value of a symbol in 
the module being assembled to other modules in a program. The EXTRN 
directive is used to reference the value of a symbol which is defined in 
another module. The syntax and operation of these directives is described 
in more detail below. 


When the assembler encounters a reference to an external symbol, it gives 
the symbol a value of zero in its expression and records the fact that the 
symbol was referenced at that location in the file. When the object files 
for the modules are combined, 386! LINK adds the actual value of the 
external symbol to the expression in which it was used. 


7.2 PUBLIC Directive 


Syntax: 
PUBLIC name,... 


The PUBLIC directive makes available the value of one or more symbols 
defined in the module being assembled to other modules in the program. 
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The name parameter can be a variable, an instruction label or an absolute 
constant. 


Defining a symbol as public does not affect its use in its defining module. 
In its module, it is treated just like any other local symbol. The only 
difference is that some extra information about the symbol is recorded in 
the assembler object output file which enables 386! LINK to resolve 
references to it. 


Exactly one PUBLIC definition must appear for a global symbol. Ifa 
symbol is defined as public in more than one module of a program, 
386 | LINK signals a duplicate symbol definition. 


Example: 


The example below shows how the values of several different symbols are 
made available to other modules in a program. 


PUBLIC Ci, C2, Vi, wz, 11, 12, 13 


cl EQU 1000h 


c2 = "hi' 

vl DW 10FFh 
v2 LABEL word 
11: 

12 LABEL near 


i PROC far 


Please see also: EXTRN (7.3) 


7.3 EXTRN Directive 


BOE MR Dien taks $008 a nn el a 
Syntax: 


EXTRN name:type,... 


The EXTRN directive tells the assembler that the symbol name is defined 
outside the module being assembled and has a data type of type. The type 
specifier can be any of the assembler-defined data types, the name of a 
structure or record definition, or the keyword ABS, which indicates that 
the symbol is an absolute constant. A list of valid type specifiers follows: 
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BYTE 
WORD 
DWORD 
PWORD / FWORD 
QWORD 
TBYTE 
NEAR 

FAR 

ABS 
structurename 
recordname 


Although the value of the symbol is not known until link time, the 
assembler assumes a segment for variables and labels based on the 
position of their defining EXTRN statement. If the EXTRN directive 
appears inside a segment block, all variables and labels defined by it are 
assumed to be in that segment, and the assembler generates override bytes 
as necessary. If the directive does not appear inside a segment block, labels 
and variables defined by it are not assumed to be in any particular 
segment. In this case, the assembler assumes that no override bytes will 
be necessary to reference them. In any case, the segment to which any 
expression is relative can be specified with the segment override operator, 
if necessary. 


Example: 


The following example demonstrates how a variable, a label, and a 
constant external to the current module can be referenced: 


EXTRN number:WORD, scale:ABS, print_num:NEAR 


foo PROC near 
mov ax, number ; Get the number. 
add ax,scale ; Scale it. 
call print_num ; And print its value. 
ret ; 
foo ENDP 


Please see also: PUBLIC (7.2), Segment Overrides (9.3.10) 
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7.4 Redefining an External Symbol as Public 


386 | ASM permits a symbol defined as external to be redefined as a public 
symbol within the module being assembled with one restriction: the 
symbol cannot be referenced between the line which declares it external 
and the line which changes its definition to public. That is to say, once an 
external is referenced in a module, its definition is locked as external and 
cannot be changed. In order to avoid assembler errors, the following 
sequence must be used to correctly redefine an external as public: 


EXTRN foo:near ; External Definition. 
; foo cannot be referenced here. 
PUBLIC foo ; Redefinition as a public. 
; foo CAN be referenced here, and will follow 
; the normal rules for forward references 


; (the data type specified in the EXTRN is 
removed by the PUBLIC redefinition). 


=e ~ ~ 


foo PROC NEAR’ ; Actual declaration of foo. 
+ foo can be referenced here. 


Any other ordering of a symbol’s EXTRN declaration, its PUBLIC 
redefinition, and references to it are considered to be an error. 


This feature makes the definition of interfaces in a large system less 
complicated. The global variables and entry points for all modules in the 
system are defined as external in one header file which is included in all 
modules. Each module includes this external definitions file, then 
immediately follows with PUBLIC definitions for any symbols which are 
actually defined in the module. Thus, each module does not have to 
explicitly declare which external symbols it is going to reference, and all 
modules include one header file to define all the globals in the system. 
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Introduction 


The assembler control directives are used to change parameters which are 
global to the entire assembly. This chapter includes descriptions of the 
instruction set control directives, the listing file control directives, the 
conditional directives, and miscellaneous control directives. 


Instruction Set Directives 


The instruction set directives select the target CPU and the numeric 
coprocessor for the assembly. Some assembler directives and instruction 
mnemonics are target CPU specific and are enabled/disabled by these 
directives. The instruction set directives which appear in a source file 
override any values specified on the command line. They are, however, 
required to appear before the first segment of the module is defined. 


Please see also: Instruction Set Switches (2.2.5) 


8.2.1 .8086 Directive 


Syntax: 
- 8086 


The .8086 directive specifies the target CPU for the assembly as an 8086 or 
an 8088. All instructions specific to the 80186, 80188, 80286, or 80386 are 
disabled, and any segments defined in the module use a 16 bit location 
counter. After processing this directive, 3861 ASM essentially becomes an 
8086 assembler. 


Assembler Control Directives 


nr 
8.2.2 .186 Directive 
Syntax: 
. 186 
The .186 directive specifies the target CPU for the assembly as an 80186 or 


an 80188. All instructions specific to the 80286 or the 80386 are disabled, 
and any segments defined in the module use a 16 bit location counter. 


8.2.3 .286 and .286c Directives 


Syntax: 


286 
-286c 


The .286 and .286c directives are synonymous and can be used 
interchangeably. They select an 80286 as the target CPU for the assembly, 
but do not enable the protected instructions. Any instructions specific to 
the 80386 are disabled, and any segments defined in the module use a 16 
bit location counter. 


8.2.4 .286p Directive 


Syntax: 
.286p 
The .286p directive specifies the target CPU for the assembly as an 80286 


and also enables the protected instructions. All instructions specific to the 


80386 are disabled, and any segments defined in the module use a 16 bit 
location counter. 


The .286p directive is equivalent to the .286 directive followed by the 
-PROT directive. 
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8.2.5 .386 and .386c Directives 


Syntax: 


. 386 
.386c 


The .386 and .386c directives are synonymous and can be used 
interchangeably. They select the target CPU for the assembly as an 80386, 
but do not enable the protected instructions. When the target CPU is an 
80386, the default use type for segments is USE32, and a 32 bit location 
counter is used. 


The 80386 nonprotected instruction set is the default instruction set 
enabled by 386! ASM. If the source file does not have an instruction set 
directive and if no instruction set switch is used on the command line, 
the nonprotected 80386 instruction set is enabled. 


8.2.6 .386p Directive 


Syntax: 
. 386p 
The .386p directive specifies the target CPU for the assembly as an 80386 


and also enables the protected instructions. The default use type for 
segments is USE32, and a 32 bit location counter is used. 


The .386p directive is equivalent to the .386 directive followed by the 
-PROT directive. 


8.2.7 .PROT Directive 


Syntax: 

. PROT 
The .PROT directive enables the protected instructions without changing 
the target CPU for the assembly. Though it only makes sense to use this 


directive when the target CPU is an 80286 or an 80386, it is processed with 
no effect if the target CPU is an 8086 or an 80186. 
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8.2.8 .8087 Directive 


Syntax: 
. 8087 


The .8087 directive enables the 8087 floating point coprocessor instruction 
set. It does not change the target CPU for the assembly. 


8.2.9 .287 Directive 


Syntax: 
287 


The .287 directive enables the 80287 floating point coprocessor instruction 
set. It does not change the target CPU for the assembly. One difference 
between the 8087 and the 80287 instruction sets is the addition of the 
FSETPM instruction for the 80287. Also, the FENI and FDISI instructions 
generate no object code if the target CPU is an 80287. 


The important change which takes place when the 80287 is selected is that 
3861 ASM does not generate FWAIT instructions preceding floating point 
instructions if the target CPU is an 80286 or an 80386 and the target 
coprocessor is an 80287. This is because floating point operations are 


synchronized by the processors and the FWAIT instructions are 
unnecessary. 


8.2.10 .387 Directive 


Syntax: 
. 387 


The .387 directive enables the 80387 floating point coprocessor instruction 
set. It does not change the target CPU for the assembly. 
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8.3 List File Control Directives 


The list file control directives are used to control the format of the 
assembler listing file. 386! ASM provides directives which set the page 
title and subtitle, and directives to control which source lines are copied to 
the listing file. 


8.3.1 TITLE Directive 


Syntax: 


TITLE text 


The TITLE directive sets the title field of the listing file page header to the 
text which follows the directive on the line. Only one title is permitted 
per module. If 386! ASM encounters more than one title for a module, it 
signals an error, and the first title is used. 


If the module does not have a name specified with the NAME directive, 
the first six characters of the module’s title are used as its name. 


Example: 


Set the title of the module to "386|ASM TITLE 
demonstration" and the name of the module 
to “386\1AS". 


™e Se Me Me fe 


TITLE 386|/ASM TITLE demonstration 


Please see also: SUBTTL (8.3.2), NAME (3.3) 


8.3.2  SUBTTL Directive 


Syntax: 


SUBTTL {text} 


The SUBTTL directive is used to set the subtitle field of the listing file 
page header to the text which follows the directive on the line. The text 


386IASM Reference Manual 95 


Assembler Control Directives 


parameter is optional; if no text follows the directive, the subtitle field of 
the header is cleared. 


More than one SUBTTL directive may appear in a module being 
assembled. Each one will take effect on the next page of the listing file. 


Example: 


; Set the subtitle field to Subtitle #1. 


SUBTTL Subtitle #1 


Please see also: TITLE (8.3.1) 


8.3.3 PAGE Directive 


Syntax: 


PAGE {length}, {width} 
PAGE + 
PAGE 


The PAGE directive has different effects, depending on the syntax in 
which it is used. If used with an optional length and/or width, it will 
change the listing file page length and width to the values specified. The 
length parameter, if present, must be between 10 and 255 lines, and the 
width parameter must be between 60 and 132 characters. If the length or 
width is omitted, its value remains unchanged. 


If the directive is followed by a single plus sign (+), it causes 386 | ASM to 
increment the section number field of the page number used in the page 
header, and generates a page break in the listing file. 


If the directive is used with no arguments, it generates a page break in the 
listing file. 


Example: 


*; Set the page length and width to 60 lines and 
; 132 columns, respectively. 
PAGE 60,132 
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; Set the length to 60 without changing the width. 
PAGE 60, 


; Set the width without changing the length. 
PAGE ,132 


; Bump the section number of the page number. 
PAGE + 


; Generate a page break in the listing file. 
PAGE 


8.3.4 .LIST Directive 


Syntax: 
. LIST 
The .LIST directive enables the listing of program statements in the listing 


file. It is used to reverse the effect of the .XLIST directive. Listing of 
program statements is enabled by default when assembly begins. 


ee ee ee ae De ee es ee 
8.3.5 .XLIST Directive 
Syntax: 
.XLIST 
The .XLIST directive disables the listing of program statements in the 


listing file. All subsequent source lines are not displayed in the listing file 
until a .LIST directive is processed. 


Pe eee ee es es Oe 
8.3.6 .LISTI Directive 
Syntax: 


-LISTI 


The .LISTI directive causes program statements included from another 
file to be listed in the listing file. It is used to reverse the effect of the 
-XLISTI directive. This is the default when assembly begins. 
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Please see also: INCLUDE (3.5) 


deat 


8.3.7. The .XLISTI Directive 


Syntax: 

.XLISTI 
The .XLISTI directive causes program statements included from another 
file to be suppressed from the listing file. All subsequent source lines 
included using the INCLUDE directive are not listed in the listing file 
until a .LISTI directive is processed. 


Please see also: INCLUDE (3.5) 


8.3.8 .LFCOND Directive 


Syntax: 
. LFCOND 
The .LFCOND directive causes text in false conditional blocks to be 


displayed in the assembler listing file even though it is not being 
assembled. 


Please see also: Conditional Assembly (8.4) 


8.3.9 .SFCOND Directive 


Syntax: 
. SFCOND 


The .SFCOND directive suppresses the listing of all subsequent false 


oe blocks in the listing file. This is the default when assembly 
egins. 


Please see also: Conditional Assembly (8.4) 
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8.3.10 .TFCOND Directive 


Syntax: 

. TFCOND 
The .TFCOND directive toggles the current state of the “list false 
conditional blocks” flag in the assembler. If false conditional blocks are 


currently being listed, they will be suppressed. If they are being 
suppressed, the .TFCOND directive causes them to be listed again. 


Please see also: Conditional Assembly (8.4) 


8.3.11 .LALL Directive 


Syntax: 
. LALL 


The .LALL directive causes all program statements generated due to 
macro expansions to be listed in the listing file. 


Please see also: Macro Expansions (10.3) 


8.3.12 .SALL Directive 


Syntax: 
. SALL 


The SALL directive causes any program statements generated due to 
macro expansions to be suppressed from the listing file. 


Please see also: Macro Expansions (10.3) 


Dee A a aS ne ee 
8.3.13 .XALL Directive 


Syntax: 
.XALL 
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The .XALL directive causes only those program statements from macro 
expansions which generate object code to be listed in the listing file. This 
is the default when assembly begins. 


Please see also: Macro Expansions (10.3) 


8.4 Conditional Assembly Directives 


The conditional assembly directives allow the programmer to specify 
whether or not a certain block of instructions will be assembled based ona 
conditional parameter. The desired condition is specified by selecting the 
appropriate conditional assembly directive, described in sections 8.4.1- 
8.4.8. 


The simplest form of conditional assembly is a code block which begins 
with a conditional assembly directive, and is terminated by the ENDIF 
directive. The instructions in the conditional block are assembled only if 
the specified condition is met. The general structure of this form of 
conditional assembly looks like this: 


IF (some condition is true) 


(instructions to be assembled if the 
condition is met) 


ENDIF (terminate the conditional block) 


Conditional assembly directives can be used with the ELSE directive to 
select one of two blocks of code to be assembled. The first block of code, 
referred to as the “true portion” of the conditional block, begins with the 
conditional assembly directive and is terminated by the ELSE directive. 
The true portion of the conditional block is assembled only if the specified 
condition is met. The second block of code, referred to as the “false 
portion” of the conditional block, begins with the ELSE directive and is 
terminated by the ENDIF directive. The false portion of the conditional 
block is assembled only if the specified condition is not met. The general 
structure of this form of conditional assembly looks like this: 
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IF (some condition is true) 
(true portion: instructions to be 
assembled if the condition is met) 
ELSE 


(false portion: instructions to be 
assembled if the condition is not met) 


ENDIF (terminate the conditional block) 


Conditional blocks may be nested up to 255 levels. An ENDIF is always 
matched to the nearest preceding IF or ELSE. 


8.4.1 IF Directive 


Syntax: 
IF expression 
The IF directive assembles the instructions in the true portion of a 


conditional block, if the expression which follows it on the line evaluates to 
a non-zero value. 


Example: 
IF 5 
DB 0 ; will be assembled 
ELSE 
DB 1 ; will not be assembled 
ENDIF 


LL 


8.4.2 IFE Directive 
Syntax: 
IFE expression 


The IFE directive assembles the instructions in the true portion of a 
conditional block, if the expression which follows it on the line evaluates to 
zero. 
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Example 
IFE 5 
DB 0 ; will not be assembled 
ENDIF 


8.4.3 IFDEF Directive 


Syntax: 


IFDEF name 


The IFDEF directive assembles the instructions in the true portion of a 
conditional block, if the name which follows it on the line is a user- 
defined symbol or an assembler keyword. The name parameter must not 
be a forward reference. 


Example: 
lab: 
IFDEF lab 
jmp lab ; will be assembled 
ENDIF 


Please see also: -DEFINE (2.2.7) 


8.4.4 IFNDEF Directive 


Syntax: 


IFNDEF name 


The IFNDEF directive assembles the instructions in the true portion of a 
conditional block, if the name which follows it on the line is not a user- 
defined symbol or an assembler keyword. 


Example: 


IFNDEF lab 
lab LABEL near ; define label only if not 


; already defined 
ENDIF 


Please see also: -DEFINE (2.2.7) 
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8.4.5 IFB Directive 


Syntax: 


IFB <string> 


The IFB directive assembles the instructions in the true portion of a 
conditional block if the string which is enclosed by angle brackets is blank. 
IFB is useful for testing the presence of macro parameters. 


Example: 


def str MACRO param ; define 0-terminated string 
IFB <param> 
DB 0 
ELSE 
DB '&param', 0 
ENDIF 
ENDM 


Please see also: Macro Expansions (10.3), Parameter Substitution (10.11) 


8.4.6 IFNB Directive 


Syntax: 
IFNB <string> 
The IFNB directive assembles the instructions in the true portion of a 


conditional block if the string which is enclosed by angle brackets is not 
blank. IFNB is useful for testing the presence of macro parameters. 


Example: 
def str MACRO param ; define 0-terminated string 
iv IFNB <param> 
DB 'Sparam' 
ENDIF 
DB 0 
ENDIF 


Please see also: Macro Expansions (10.3), Parameter Substitution (10.11) 
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8.4.7. IFIDN Directive 


Syntax: 


IFIDN <stril1,str2> 


The IFIDN directive assembles the instructions in the true portion of a 
conditional block if the two strings enclosed by angle brackets are identical. 


Example: 


end_str MACRO flag ; terminate string conditionally 
IFIDN <flag>,<TRUE> 
DB 0 
ENDIF 
ENDM 


Please see also: Macro Expansions (10.3), Parameter Substitution (10.11) 


8.4.8 IFDIF Directive 


Syntax: 


IFDIF <stri,str2> 


The IFDIF directive assembles the instructions in the true portion of a 
conditional block if the two strings enclosed by angle brackets are different. 


Example: 
end_str MACRO flag ; terminate string conditionally 
IFDIF <flag>,<FALSE> 
DB 0 
ENDIF 
ENDM 


Please see also: Macro Expansions (10.3), Parameter Substitution (10.11) 
8.4.9 ELSE Directive 


Syntax: 
ELSE 
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The ELSE directive terminates the true portion of a conditional block and 
marks the start of a block of instructions, which should be assembled if the 
true block is not assembled. This block of instructions is called the false 


portion of a conditional block and must be terminated by the ENDIF 
directive. 


8.4.10 ENDIF Directive 


Syntax: 
ENDIF 
The ENDIF directive terminates a conditional block. It must appear after 


the last statement in the true portion of the block or after the last 
statement of the false portion of the block, if it exists. 


8.5 Conditional Error Directives 


The conditional error directives are used to force an assembler error, if the 
given condition is met. They are useful for signaling an error if an 
assumption made turns out to be invalid. 


8.5.1 .ERR Directive 


Syntax: 


. ERR 


The .ERR directive forces an assembler error unconditionally. 


8.5.2 .ERRE Directive 


Syntax: 


.-ERRE expression 


The .ERRE directive forces an assembler error if expression evaluates to 
zero. 
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8.5.3 .ERRNZ Directive 


Syntax: 


.ERRNZ expression 


The .ERRNZ directive forces an assembler error if expression evaluates to a 
non-zero value. 


8.5.4 .ERRDEF Directive 


Syntax: 


.-ERRDEF name 


The .ERRDEF directive forces an assembler error if name is a user-defined 
symbol or an assembler keyword. 


8.5.5 .ERRNDEF Directive 


Syntax: 


-ERRNDEF name 


The .ERRNDEF directive forces an assembler error if name is not a user- 
defined symbol or an assembler keyword. 


8.5.6 .ERRB Directive 


Syntax: 


-ERRB <string> 
The .ERRB directive forces an assembler error if string is blank. 
8.5.7 .ERRNB Directive 


Syntax: 


-ERRNB <string> 


The .ERRNB directive forces an assembler error if string is not blank. 
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8.5.8 .ERRIDN Directive 


Syntax: 


-ERRIDN <strl,str2> 


The .ERRIDN directive forces an assembler error if strings str1 and str2 are 
identical. 


8.5.9 .ERRDIF Directive 


Syntax: 


.ERRDIF <strl,str2> 


The .ERRDIF directive forces an assembler error if strings str1 and str2 are 
different. 


8.6 Miscellaneous Control Directives 


8.6.1 % OUT Directives 


Syntax: 
SOUT text 
SOUT1 text 


SOUT2 text 


The %OUT directives are used to copy the text which follows them on the 
line to the user’s terminal. The %OUT directive copies the text on both 
passes of the assembly, while %0UT1 and %OUT2 only copies the text on 
pass one or pass 2, respectively. 


Spi ES NESE. 
8.6.2 .RADIX Directive 


Syntax: 


-RADIX expression 
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The .RADIX directive sets the default radix for all following numbers in 
the source code to expression. The expression is always evaluated in base 10, 
regardless of the current default radix. The value of expression must be 
between 2 and 16. 
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9.1 Introduction 


Many assembly language instructions or directives require operands. An 
operand may be a constant value, a relocatable value, or the name of an 
80386 register. 


For most statements which require operands, a single value may be 
replaced by a more complex expression which evaluates to a constant or 
relocatable value. An expression combines operands through the use of 
expression operators to calculate a single value. For the remainder of this 
chapter, the word operand will refer to a single constant value or a 
relocatable value in an expression (as opposed to an assembly language 
statement operand, which may be either a single value or an expression 
which evaluates to a single value). 


9.2 Operands 


An expression operand is either a constant value, a user-defined symbol 
(an identifier), or an assembler reserved word. An operand is either a 
constant value or a relocatable value. Relocatable values are values that 
are modified (relocated) when the assembled object code is linked, or 
when the linked program is loaded into memory for execution. 


iT 


9.2.1 Constant Operands 


A constant operand is a number, a string constant, or a user-defined 
symbol with a constant value. Table 9-1 shows the types of user-defined 
symbols that assume constant values and the value each type assumes in 
an expression. 
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TABLE 9-1 
CONSTANT SYMBOL TYPES 


Symbol Type Value 


Integer constant The value given by the EQU or = directive when the 


symbol was created. 
Structure definition The size, in bytes, of the structure. 
Structure field The offset, in bytes, of the field within the structure. 
Record definition The size, in bits, of the record. 


Record field The offset, in bits, of the field within the record. 


Please see also: Defining Constants With the EQU and = Directives 
(Chapter 4), Structure Definitions (6.6), RECORD (6.9) 


9.2.2 Relocatable Operands 


A relocatable operand is a user-defined symbol whose final value is not 
determined until the object modules are linked to make a task image, or 
until the task image is loaded into memory for execution. Table 9-2 shows 
relocatable user-defined symbols and their values. 
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TABLE 9-2 
RELOCATABLE OPERANDS 


Symbol Type Value 


Variable, structure, record, The offset of the symbol within the segment in 
label, or procedure label which it is defined. The final value is assigned at 
link time. 


A special symbol which represents the current 
offset within the current segment. It has the same 


attributes as a near label. The final value is 
assigned at link time. 


Segment or group For 8086, 8088, 80186 or 80188 programs, or for 80286 
or 80386 real mode programs, this is the paragraph 
address (where paragraphs begin on 16-byte 
boundaries) at which the segment or group is 
loaded into memory. For 80386 or 80286 protected 
mode programs, this is the index of a segment 
descriptor in a table maintained by the operating 
system. The segment descriptor gives the segment 
location in memory and other information about the 
segment. In either case, the final value is assigned 
at the time the program is loaded into memory for 
execution. 


Please see also: Variables and Data Declarations (Chapter 6), SEGMENT 
(3.7), GROUP (3.9), Chapter 11 


ge inane gntitchenasitticie cir a LALA 


9.2.3 Assembler Reserved Words 


A few assembler reserved words are valid expression operands. 
Assembler reserved words that are not valid operands are simply assigned 
a constant value of zero when encountered in an expression. Table 9-3 
shows assembler reserved words which are valid expression operands, 
and the values they are assigned. 
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TABLE 9-3 
RESERVED WORD VALUES 


Reserved Word Value 


Register names Register names are valid in effective address 
expressions (see section 9.4) used with instruction 
opcodes. 


BYTE A constant value of one 


FAR A constant value of -2 


‘tlpsitnieeem gece eee MCC ery FN ye erss—“(‘i 
9.2.4 Forward References 


An expression which uses an identifier (a user-defined symbol) before it 
is defined in the source code file is said to be a forward reference to the 

identifier. Forward references are permitted, provided the assumptions 
made by 386! ASM about the identifier cause at least as much object code 


to be generated on pass one of the assembly as is written to the object file 
on pass 2. 


If 3861 ASM generates an illegal forward reference error, the condition 
may be corrected either by moving the identifier definition in front of the 
statement that references it, or by giving the assembler more information 
about the identifier in the statement that forward references it. The PTR 
operator and the segment override operator (:) are used to give the 
assembler additional information about forward referenced identifiers. 


In some cases, it may not be possible to give 3861 ASM sufficient 
information about the forward reference. Then, the only option is to 
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move the definition above the statement that references it. For example, 
the text substitution symbol defined by the statement 


long_str EQU 'This is a long string' 


cannot be forward referenced under any circumstances by the statement 


DB long str 


because the assembler needs to know how much space to reserve for the 
string on pass one. 


Please see also: PTR (9.3.7), Segment Override (9.3.10), SHORT (9.3.12) 


9.3 Operators 


Expression operators are used to combine multiple operands into a single 
constant value or a relocatable value. Operators are assigned a precedence 
ranking which is used to determine the order of evaluating expressions. 
Operators of higher precedence are evaluated before operators of lower 
precedence. Operators of equal precedence are evaluated left to right. 
Operator precedence may be overridden through the use of parentheses 
within the expression. Operations within parentheses are always 
evaluated before adjacent operations. Appendix H contains tables which 
summarize all the expression operators and show operator precedence. 


| IP ch ao sa an at Ses 2 
9.3.1 Arithmetic Operators 


The arithmetic operators perform the standard mathematic operations. 
Table 9-4 shows the arithmetic operators, their syntax, and their use. 
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TABLE 9-4 
ARITHMETIC OPERATORS 


Use 


Adds the two operands. If both operands are 
constant, the result is constant. If one operand is 
relocatable, the result is relocatable. At least one 
operand must be constant. 


Subtracts expr2 from expr1. If both operands are 
constant, the result is constant. If both operands are 
relocatable relative to the same segment, the result 
is a constant. If the left hand operand is 
relocatable and the right hand operand is constant, 
the result is relocatable. Any other use of 
relocatable operands is illegal. 


expr * expr2 Multiplies the two operands. Both operands must 
be constant, and the result is constant. 


expr1 / expr2 Divides expr1 by expr2, truncating the fractional 
part of the result. Both operands must be constant, 
and the result is constant. 


exprl MOD expr2 The modulo operator. Gives the remainder when 
exprl is divided by expr2. Both operands must be 
constant, and the result is constant. 


The unary addition operator. Yields the value of 
expr. The operand may be either constant or 
relocatable, and the result is the same. 


The unary minus operator. Inverts the sign of expr. 
The operand must be constant, and the result is 


constant. 
Example: 
varl DB 0 
var2 DB 0 
DW 2+ 3 ; constant value 5 
DW 2 + vari * relocatable value 
DD var2 + 3 ; relocatable value 
114 


386IASM Reference Manual 


Expressions 


DB 2-3 ; constant value -1 
DW var2 - varl ; constant value 1 
DW var2 - 1 ; relocatable value 
DD az * 3 7 constant value 6 
DD 9/2 ; constant value 4 
DD 9 MOD 2 ; constant value 1 
DB = at | ; constant value 1 
DB -1 7; constant value -1 
DB +(2 - 3) ; constant value -1 
DB -(2 - 3) + constant value 1 


9.3.2 Bitwise Operators 


The bitwise operators are provided for bit manipulation of numeric 
values. All operands to the bitwise operators must be constant, and the 
result is always constant. Table 9-5 shows the bitwise operators. 


TABLE 9-5 
BITWISE OPERATORS 


Use 


Result is the one’s complement of expr. When the 
NOT operator is the last operator applied in an 
expression, less stringent rules are applied for 
posting an integer overflow error. This is so using 
NOT to turn off the most significant bit of a flag 
word or byte will not cause an overflow error. 


Result is the bitwise AND of the two operands; 
that is, all bits that are one in both operands are 
also one in the result, and all bits that are zero in 
either operand are 0 in the result. 


expr1 OR expr2 Result is the bitwise inclusive OR of the two 
operands; that is, all bits that are one in either 
operand are one in the result, and all bits that are 
zero in both operands are 0 in the result. 
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TABLE 9-5, CONTINUED 


Operator Syntax Use 


XOR expr1 XORexpr2 _ Result is the bitwise exclusive OR of the two 
operands; that is, all bits that are the same in the 
two operands are zero in the result, and all bits 
that are different in the two operands are one in 
the result. 


expr1 SHL expr2 Result is expr1 shifted left by the number of bits 
specified by the value of expr2. Zero bits are 
shifted in on the right. 


expr1 SHRexpr2 _ Result is expr1 shifted right by the number of bits 
specified by the value of expr2. Zero bits are 
shifted in on the left. 


LOW LOW expr Result is byte zero of expr. Equivalent to expr AND 
OFFh. 
HIGH HIGH expr Result is byte one of expr. Equivalent to (expr AND 
OFFOOh) SHR 8. 
LOWW LOWW expr Result is bytes zero and one of expr. Equivalent to 
expr AND OFFFFh. 
HIGHW ~— HIGHW expr Result is bytes two and three of expr. Equivalent to 
(expr AND OFFFF0000h) SHR 16 
Example: 
DB NOT OFh ; OFOh 
DB OFFh AND OFh ; OFh 
DB OFOh OR OFh ; OFFh 
DB OFFh XOR OFh ; OFOh 
DB OFh SHL 2 7 03Ch 
DB OFFh SHR 3 ; 1Fh 
DB OFh SHL (1 + 3) ; OFOh 
DD LOW OFFASASFFh ; OOOOOOFFh 
DD HIGH OFFASASFFh ; 000000A5h 
DD LOWW OFFASASFFh ; QOOOASFFh 
DD HIGHW OFFASASFFh ; OOOOFFASh 
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9.3.3 Relational Operators 


The relational operators compare two operands and return a TRUE or 
FALSE value as their result. Both operands must be constant values. A 
TRUE result is returned as negative one (all bits set to one), and a FALSE 
result is returned as zero. A summary of the relational operators appears 
in Table 9-6. 


TABLE 9-6 
RELATIONAL OPERATORS 


Operator Syntax Use 


E 


N expr1 NE expr2 Result is TRUE if the operands are not equal 


expr1 EQ expr2 Result is TRUE if the operands are equal. 


Q 
E i i , 
La exprl LT expr2 Result is TRUE if expr] is less than expr2. 
GT expr1 GT expr2 Result is TRUE if expr1 is greater than expr2. 
LE exprl LE expr2 Result is TRUE if expr] is less than or equal to expr2. 
GE expr1 GE expr2 Result is TRUE if expr1 is greater than or equal to 
expr2. 
Example: 
DW 2 EQ 3 ; g 
DW 2 NE 3 ; OFFFFh 
DB 2 LT 3 ; OFFh 
DW 2 GT 3 ; 0 
DD 5 ix Ss ; OFFFFFFFFh 
DW 2 GE 3 7 @ 


9.3.4 LENGTH and SIZE Operators 
Syntax: 


LENGTH variable 
SIZE variable|structure| record 
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The LENGTH operator returns the number of elements of storage 
allocated for a variable. The size of each element depends on the data type 
of the variable and is not related to the value returned by LENGTH. 


The SIZE operator returns the number of bytes of storage allocated fora 
variable. It is equivalent to (LENGTH variable) * (TYPE variable). 


The SIZE operator can be used with structure and record variables, and 
with structure and record definition names, to obtain the size in bytes of 
the structure or record. The LENGTH operator cannot be used with 
structures or records. 


Example: 

sl STRUC 
DB 0 
DW 0 

sl ENDS 

rl RECORD f£1:8,£2:4 

strucl sl <> 

recl rl <> 

varl DB 0 

var2 DB G,1i,2 

var3 DW 0,1,;2 

var4 DD 0,10 DUP (?),1 
DW LENGTH varl 5g a 
DW LENGTH var2 ; 3 
DW LENGTH var3 i 2 
DW LENGTH var4 ; i2 
DW SIZE varl : 1 
DW SIZE var2 : 3 
DW SIZE var3 ; 6 
DW SIZE var4 : 48 
DW SIZE sl es 
DW SIZE strucl ; 3 
DW SIZE rl : 2 
DW SIZE recl :2 


Please see also: Variables and Data Declarations (Chapter 6) 
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9.3.5 WIDTH and MASK Operators 


Syntax: 


WIDTH recdefname|recfldname 
MASK recdefname|recfldname 


The WIDTH operator returns the number of defined bits in a record 
definition or the number of bits in a record field. (Note that the WIDTH 

of a record definition is not equal to the amount of storage that is allocated 
when the record definition is used, unless all of the bits in the record 
definition are defined. The size of a record is always 8, 16, or 32 bits, and 
may be obtained by using the record name directly, without any 
expression operators.) 


The MASK operator returns a mask for the defined bits in a record 
definition or a mask for a single field in its record. 


Example: 


rdefl RECORD 


recl rdefl 


DW 
DW 
DW 


DW 
DW 
DW 
DW 


DW 
DW 
DW 
DW 


Please see also: 


rfidil 12, r8102:8, rtid3:2 


<1,5,0> 


WIDTH rdefl 
WIDTH rfldl 
WIDTH rfld2 


MASK rdefl 
MASK rfldl 
MASK rfld2 
MASK rfld3 


rdefl 
rfldl 
SIZE rdefl 
SIZE recl 


RECORD (6.9) 
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eo Me Be Fe 


i! 
2 
8 


O7FFh 
0600h 
01FEh 
0001h 


16 - size of record, in bits 
9 - offset of field, in bits 
2 - size of record, in bytes 
2 - size of record, in bytes 


; Allocate storage for a record 
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9.3.6 TYPE Operator 


Syntax: 


TYPE expression 


The TYPE operator returns a constant value representing the data type of 
expression. For variable data types, the value returned is the size of the 
data type in bytes. For label data types, the value returned is negative one 
if the label is NEAR, and negative two if the label is FAR. Please see Table 
9-3 for a complete list of values returned. 


For convenience, the TYPE operator can be used as synonym for the SIZE 
operator for structures and records. It returns the size in bytes of the 
structure or record. 


Example: 
varl DB 0 
var2 DD 0 
labl LABEL near 
DW TYPE varl , 1 
DW TYPE var2 7; 4 
DW TYPE labl ; =] 


Please see also: Variables and Data Declarations (Chapter 6), Instruction 
Labels, Control Transfer, and Procedure Blocks 
(Chapter 5) 


9.3.7 PTR Operator 


Syntax: 


type PTR expression 


The PTR operator gives expression a data type of type, where type is either 
one of the data type reserved words or their integer value equivalents 

given in Table 9-3. The PTR operator is useful for giving the assembler 
information about the data type of forward referenced symbols. It causes 
the assembler to assume that a forward referenced symbol has a data type 


which is different from the default assumed for a forward referenced 
symbol. 
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Example: 
varl DB 0 
var2 DQ 0 


mov al,byte PTR var2 load low byte 

of var2 

load second 
byte of var2 
tell assembler 
that forward 
referenced label 
is of type FAR 


mov ah, (TYPE varl) PTR var2 + 1 


call far PTR labl 


ee Se Fe Fe Fel lel CU 


labl LABEL far 


Please see also: Forward References (9.2.4) 


9.3.8 SEG Operator 


Syntax: 


SEG expression 


The SEG operator returns the segment selector value for expression. The 
resulting value is relocatable and is 16 bits wide, and its final value is not 
determined until the program is loaded into memory for execution. 


For 8086, 8088, 80186, or 80188 programs (or for 80286 or 80386 real mode 
programs), the segment selector is the segment paragraph address — i.e., 
the address of the 16 byte boundary where the segment is located. To turn 
a segment paragraph address into a byte address, it must be shifted left 
four bits to create a 20 bit wide byte address. 


For 80286 or 80386 protected mode programs, the segment selector is an 
index of a segment descriptor in a table maintained by the operating 
system. Each entry in the descriptor table identifies the address where the 
segment is located, its length, and other information about the segment. 
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Example: 


mov ax, SEG varl ; load selector for segment variable 
; varl is located in 

mov ax,SEG labl ; load selector for segment label 
; labl is located in 


Please see also: Chapter 11 


9.3.9 Structure Field Operator 


Syntax: 


expression. strucfldname 
exprl.expr2 


The structure field operator (.) is used to index to a field within a 
structure. It adds the offset of the structure field within the structure to 
expression, and converts the data type of expression to the data type of the 
structure field. 


The structure field operator may also be used as a synonym for + to add 
two expressions. 


Example: 
sdefl  STRUC 
sfldl DB 0 
sfld2 DW 0 


sdefl ENDS 


strucl sdefl “1.6> ; allocate storage for a 
*; Structure 
mMOv al, strucl.sfldl ; load byte at offset 0 
: in. strucl 
Mov bp,OFFSET strucl ; load pointer to 
¢ strucl 
Mov ax, [bp] .sfld2 ; load word at offset 1 


; an atrucl 


Please see also: Referencing Structures (6.8) 
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9.3.10 Segment Override Operator 


Syntax: 


segregister:expression 
segname:expression 
groupname:expression 


The segment override operator (:) is used to aid the assembler in 
producing correct object code for memory references which do not use the 
default segment register. By default, references to data use DS, SS, or ES as 
the default segment register, depending on the instruction (the vast 
majority of references assume DS, stack instructions assume SS, and some 
string move instructions assume ES). 


If an instruction references data in a segment that is not pointed to by the 
default segment register assumed for that instruction, a segment override 
byte must precede the instruction. This segment override byte tells the 
processor which segment register to use to access the data. 386! ASM 
automatically generates a segment override byte for references to symbols 
that are defined before the line that references them. If a symbol is 
forward referenced, and it is in a segment not pointed to by the default 
segment register, the segment override operator must be used to tell 

386 | ASM that a segment override byte is required. 


If a segment name or group name is used with a segment override, the 
assembler must have previously been informed (with the ASSUME 
directive) which segment register will point to the segment or group, so 
that it can generate the correct override byte. 


Note that it is possible to use a segment override to a segment other than 
the segment in which a variable is defined. This may be necessary, for 
example, if no segment register is set up to point to the segment the 
variable is defined in. In this case, the assembler not only outputs a 
segment override byte if necessary; it also forces the relocatable offset of 
the variable to be computed relative to the segment used in the segment 
override, rather than to the segment in which it is defined. This mS 
necessary in order for the processor to reference the correct location; since 
the segment register used points to the segment used in the segment 
override, the offset must also be relative to that segment. This type of 
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segment override cannot be used with 80286 or 80386 protected mode 


programs. 


Example: 


dsegl 
varl 
dsegl 
dseg2 
var2 
dseg2 
cseg 


var3 


forw3 


cseg 
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ASSUME 
SEGMENT 
DW 

ENDS 
SEGMENT 
DW 

ENDS 
SEGMENT 
DW 


mov 


mov 


mov 


mov 


mov 


mov 


mov 


mov 


mov 


ENDS 


cs:cseg,ds:dsegl,es:dseg2 


0 
ax,varl 


ax, var2 


ax, var3 


ax, forwl 


ax,es:forw2 


ax, dseg2:forw2 


ax,cs:forw3 


bp, OFFSET var2 


ax,es: [bp] 


no segment override 
necessary 

segment override to ES 
automatically generated by 
386|ASM 

segment override to CS 
automatically generated by 
386|ASM 

no segment override 
necessary 

386|ASM must be told 
that a segment 
override is necessary 
another way of doing 
the same thing 
386|ASM must be told 
that a segment 
override is necessary 
load pointer to var2, 
relative to ES 
386|ASM must be told 
that a segment 
override is necessary 
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dsegl SEGMENT 
forwl DW 0 
dsegl ENDS 


dseg2 SEGMENT 
forw2 DW 0 
dsegl ENDS 


Please see also: Chapter 11, Forward References (9.2.4), OFFSET (9.3.11), 
ASSUME (3.10) 


9.3.11 OFFSET Operator 


Syntax: 


OFFSET expression 


The OFFSET operator returns the offset of expression relative to the 
segment in which it is defined. It is useful for loading the effective 
address of a label or variable into a register. 


Note that if a segment override is used in the expression, the offset 
returned is relative to the segment specified in the override, rather than 
to the segment in which the variable or label is defined. This is necessary 
to compensate for a shortcoming in the assembly language definition. Ifa 
variable is defined in a segment that is within a group, and the group is 
pointed to by a segment register, memory references to the variable 
correctly relocate the variable offset relative to the group. However, the 
OFFSET operator returns the offset of the variable within the segment 
rather than within the group, so a segment override to the group must be 
used to obtain the correct offset value. 


If the OFFSET operator is used on a non-relocatable value, it returns the 
value of the expression. This feature can be used for code clarity when a 
structure field offset must be used as an immediate value. 


Example: 
ASSUME cs:cseg,ds:dgroup 
dgroup GROUP dsegl,dseg2 


dsegl SEGMENT 
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varl DW 
dsegl ENDS 
stri STRUC 
fieldl DB 
field2 DW 
field3 DD 
strl ENDS 


dseg2 SEGMENT 


var2 DW 0 
dseg2 ENDS 
cseg SEGMENT 
Mov ax,var2 ; offset correctly relocated 
lea bp, var2 ; offset correctly relocated 
mov ax, [bp] 
mov bp,OFFSET dgroup:var2 ; segment override 
mov ax, [bp] ; must be used to 
; make offset be 
7 correctly 
; relocated 
mov ax,OFFSET labl ; offset relocated 
; correctly 
jmp ax 
labl: 
mov ax,OFFSET field2 ; offset of 


cseg ENDS 


; structure field 


Please see also: SEGMENT (3.7), GROUP (3.9), Segment Override 
(9.3.10) 


9.3.12 SHORT Operator 


Syntax: 
SHORT label 


The SHORT operator instructs 3861 ASM to generate a short (eight byte) 
offset to a label in a jump instruction. The label must be no more than 
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127 bytes from the jump instruction, or an error will be generated. 
Judicious use of the SHORT operator allows the assembler to generate less 
code. It is only necessary to use the SHORT operator if the label is being 
forward referenced. For references to labels defined above, 386! ASM 
automatically generates a short offset, if possible. 


Example: 
labl: 
jmp labl ; short offset 
; automatically generated 
jmp SHORT lab2 ; tell assembler to 
; generate short offset 
lab2: 


9.3.13 THIS Operator 


Syntax: 
THIS datatype 


The THIS operator creates an operand with the specified data type, with a 
relocatable value equal to the current offset within the current segment. 
The datatype parameter must be one of the assembler reserved words 
given in Table 9-3. 


Example: 
mov al,THIS byte ; load first byte of MOV 
; opcode 
labl equ THIS near ; equivalent to labl: or 


>; labl LABEL near 


9.3.14 .TYPE Operator 
Syntax: 
. TYPE expression 


The .TYPE operator returns a constant value giving information about the 
expression. Table 9-7 shows the defined bits in the returned value. All 


other bits in the returned value are guaranteed to be zero. 
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TABLE 9-7 
BIT DEFINITIONS FOR .TYPE OPERATOR 


Meaning 


If the bit is 1, the expression has a label data type. Otherwise, 
the bit is 0. 


If the bit is 1, the expression has a variable data type. 
Otherwise, the bit is 0. 


If the bit is 1, there are no undefined symbols in the expression. If 
there is at least one undefined symbol in the expression, then this 
bit and all other bits in the returned value are set to 0. 


If the bit is 1, there is a symbol that is defined external in the 
expression. Otherwise, the bit is 0. 


9.3.15 Indirection Operator 


Syntax: 


[effective address expression] exprl[expr2] 


The indirection operator, [], is used to indicate indirection through a 
register in effective address expressions. This is described in detail in 
Section 9.4. It can also be used as a synonym for the + operator in order to 
add two expressions. 


Note that operations within brackets are always calculated before adjacent 
operations, just as with expressions in parentheses. 


Example: 


array DB 20 DUP (?) 
mov ax, [bp] indirection through BP 

register 

load the 11th element in 

array 


Mov ax,10 [array] 


RE SE Se Ve 
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9.4 Effective Address Modes 


Addressing modes on the 8086 family of processors use the concepts of 
base and index registers, displacements, and scale factors on index 
registers. A base or index register is used in register indirect addressing 
modes. A displacement is an 8, 16, or 32 bit immediate value which is 
added to an effective address calculated with one of the register indirect 
addressing modes. A displacement may be either a constant or relocatable 
value. A scale factor is a value of one, two, four, or eight that is 
multiplied by the contents of an index register before it is used to calculate 
the effective address. Table 9-8 identifies which registers may be used as 
base or index registers. Please see Appendix F for a summary of all the 
programmer-accessible registers on the 80386. 


TABLE 9-8 
BASE AND INDEX REGISTERS IN THE 8086 FAMILY 


8086,8088, 
Register Type 8018680286 80386 


Base Register BxX,BP BX,BP, any 32 bit general register 


Index Register SI,DI SIDI, any 32 bit general register except ESP 


9.4.1 Immediate Operand Mode 


Syntax: 


constant_expression 


Immediate operand mode specifies that the instruction operand is 
encoded as part of the instruction. 
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Example: 
varl DW 0 
mov ax,1 ; the value one is an 
; immediate operand 
mov ax,OFFSET varl ; the offset value is 


; an immediate 
; operand 


9.4.2 Memory Direct Mode 


Syntax: 


relocatable_expression 


In memory direct mode, the address of the instruction operand is encoded 
as part of the instruction. 


Example: 


varl DW 0 
mov ax,varl ; the operand is the data 
; located at varl the address of 
; varl is given in memory direct 
; mode 


9.4.3 Register Direct Mode 


Syntax: 


register 


In register direct mode, the operand of the instruction is the contents of a 
register. Any general register, plus the segment registers and the 80386 
control, test, and debug registers, may be used in register direct mode. 


Example: 


mov ax, bx ; The operand is the contents of BX 
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9.4.4 Register Indirect Mode 


Syntax: 


[register] 

displacement [register] 
displacement + [register] 
[register + displacement] 
[register] .displacement 
[register] + displacement 


In register indirect mode, the register contents are added to an optional 
immediate displacement to obtain the address of the instruction operand. 


Any register which may be used as a base or 
this address mode. 


Example: 
array DB 20 DUP (0) 

mov ebx,OFFSET array 
mov al, [ebx] ; 
mov al,10[ebx] ; 
mov al, [ebx+10] 

mov al, [ebx] .10 

mov ebx, 10 

mov al, array [ebx] ; 


’ 


index register may be used in 


register indirect 
register indirect with 
displacement 


register indirect with 
relocatable 
displacement 


eee 


9.4.5 Based Index Mode 


Syntax: 


[basereg] [indexreg] 

displacement [basereg] [indexreg] 
displacement + [basereg] [indexreg] 
[basereg + displacement] [indexreg] 
[basereg] [indexreg + displacement] 
[basereg] [indexreg] .displacement 
[basereg] [indexreg] + displacement 
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In based index address mode, the effective address of the instruction 
operand is given by the sum of the contents of the base and index registers 
and the optional immediate displacement. 


Example: 
array DB 20 DUP (0) 
mov bp, OFFSET array 
mov si,10 
mov al, [bp] [si] ; based index addressing 
mov al, [bp] [si] .2 ; based index with 


; displacement 


9.4.6 Scaled Index Mode 


Syntax: 


[indexreg * constant_expression] 

displacement [indexreg * constant_expression] 
displacement + [indexreg * constant_expression] 
[indexreg * constant_expression] .displacement 
[indexreg * constant_expression] + displacement 


In scaled index mode, the address of the instruction operand is given by 
the contents of the index register multiplied by a scale factor of one, two, 


four, or eight, and then added to an optional immediate displacement. 
This address mode is only available on the 80386. 


Example: 


array DD 20 DUP (0) 
Mov ecx, 2 ; 3rd entry in array 
mov eax, array [ecx*4] ; scaled index mode 


EEE 


9.4.7. Based Scaled Index Mode 


Syntax: 


[basereg] [indexreg * constant_expression] 

displacement [basereg] [indexreg * constant expression] 
displacement+ [basereg] [indexreg * constant expression] 
[baseregt+displacement] [indexreg * constant expression] 
[basereg] [indexreg * constant_expression] . displacement 
[basereg] [indexreg * constant_expression]+displacement 
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In based scaled index mode, the address of the instruction operand is 
given by the contents of the index register multiplied by the scaled factor, 
and then added to the contents of the base register and an optional 
immediate displacement. This address mode is only available on the 
80386. 


Example: 


array DD 20 DUP (0) 
mov ebx, offset array 
mov ecx,2 
mov eax, [ebx] [ecx*4] 


3rd entry in array 
based scaled index 
mode 

load high byte of 
array entry 


Mov ax, 2[ebx] [ecx*4] 


eT a? ee) eT 
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Macros and Repeat Blocks 


10.1 Introduction 


A macro is a named block of source code statements that is created with 
the MACRO directive. Once a macro is defined, it can be expanded by 
referencing it by name. When a macro is expanded, copies of the source 
code statements in the macro definition are inserted in the source code 
being assembled. Macros may also have named parameters, for which 
substitution values are specified when the macro is expanded. 


A repeat block is a sequence of source code statements that is replicated a 
specific number of times under the control of the repeat block directive 
being used. Unlike macros, there is no concept of a separate definition 
and expansion; the block is repeated in place. 


10.2 Macro Definition 


Syntax: 


name MACRO {formalparam,...} 
Statements 
ENDM 


A macro definition is created by surrounding the block of statements in 
the macro definition by the MACRO and ENDM directives. The macro is 
given a required name and an optional list of formal parameter names. 
When the macro is expanded, each occurrence of the formal parameter 
names in the statement block is replaced by the actual parameter values 
specified when the macro is invoked. The formal parameter names are 
kept with the macro definition and therefore will never conflict with 
other symbols defined elsewhere in the file. The macro name is a normal 
user-defined symbol and must be unique. There are no limits imposed on 
the number of formal parameters or the number of source code 
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statements in a macro definition, other than the requirement that all the 
formal parameter names must be listed on one line. 


No object code is generated when a macro is defined, but the macro 
definition is saved in memory. Object code is generated when the macro 
is expanded further on in the source file. A macro definition can 
therefore be placed outside a segment block, if desired. 


The following example creates a macro definition named alloc with two 
formal parameters, vall and val2, and with two source code statements. 


alloc MACRO vall,val2 


DB vall 
DB val2 
ENDM 


It is legal to redefine a macro. When the assembler encounters a new 
definition for a macro, it discards the old definition and saves the new 
one. Macro expansions after the first macro definition, but before the 
second, will use the first macro definition. Macro expansions after the 
second macro definition use the second definition. 


1 a a en en en 
10.3 Macro Expansions 


ae SP Sey ee. ais Ae 
Syntax: 


name {actualparam, ...} 


A macro is expanded when a previously defined macro is invoked by 
name. All of the source statements in the macro definition are inserted at 
that point in the source file and assembled to generate object code. Each 
occurrence of a formal parameter name in a source statement is replaced 
by the corresponding actual parameter from the macro invocation 
statement. Actual parameters are treated as character strings, and are 
separated by commas, spaces, or tabs. If there are fewer actual parameters 
than formal parameters, the missing actual parameters are assigned the 


null string. A null string may be passed for any particular actual 
parameter by entering two commas in a row. 
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When a macro is expanded, there are three options available for what will 
be printed in the listing file: all of the inserted statements will be printed, 
only statements that cause object code to be generated will be printed, or 
none of the inserted statements will be printed. The desired option can be 
selected by using the appropriate listing file directives (please see sections 
8.3.11-8.3.13). By default, only statements for which object code is 
generated are printed. 


The following examples show two statements invoking the alloc macro 
that was defined in section 10.2 and the source code statements that will be 
inserted. 


alloc 0,1 


will expand to: 


DB 0 
DB 1 


the statement: 


alloc "that's" 'show biz' 


will expand to: 


DB "that‘'s™ 
DB "show biz' 


Macros may also be recursive, and macro expansions may be nested. For 
example, the following pair of macro definitions: 


term MACRO 
DB 0 ;; Terminate the string with a zero 
73 byte 
ENDM 


bldstg MACRO val 
IFIDN <val>,<5> 


term 3; terminate the string 
ELSE 
DB 'val&' 7; next character in 
77 string 
bldstg ‘%val - 1 7; continue loop 
ENDIF 
ENDM 
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will expand to: 


bldstg 9 
DB rg! 
DB rgt 
DB iy 
DB "6! 
DB 0 


Please see also: .LALL (8.3.11), SALL (8.3.12), XALL (8.3.13), Conditional 
Assembly (8.4), Parameter Substitution (10.11) 


10.4 REPT Repeat Block 


Syntax: 


REPT expression 
statements 
ENDM 


The REPT directive causes the block of statements surrounded by the 
REPT and ENDM directives to be repeated expression number of times, 
where expression must evaluate to a constant value. For example, the 


repeat block: 
REPT 3 
DB 0 
ENDM 


DB 0 
DB 0 
DB 0 


10.5 IRPC Repeat Block 


MRM tip Ss Lace Rainn OS a 
Syntax: 


IRPC formalparam, string 
Statements 
ENDM 
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The IRPC directive causes the block of statements enclosed by the IRPC 
and ENDM directives to be repeated as many times as there are characters 
in string. Each time the statement block is repeated, the next character in 
string is substituted for formalparam. For example, the repeat block 


IRPC val,012 
DB val 
ENDM 


will expand to: 


DB 0 
DB 1 
DB 2 


Please see also: Conditional Assembly (8.4) 


10.6 IRP Repeat Block 


Syntax: 


IRP formalparam,<actualparam, ...> 
Statements 
ENDM 


The IRP directive causes the block of statements enclosed by the IRP and 
ENDM directives to be repeated once for each actual parameter in the 
actual parameter list. Each time the statement block is repeated, the 
current actualparam is substituted for formalparam. The syntax for the 
actual parameter list is exactly the same as it is for the actual parameter list 
in a macro invocation. The actual parameter list must be enclosed in 
angle brackets. For example, the repeat block: 


IRP val,<0, ‘string', 1> 
DB val 
ENDM 
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will expand to: 


DB 0 
DB "string' 
DB 1 


Please see also: Parameter Substitution (10.11), Conditional Assembly 
(8.4) 


10.7 Macro and Repeat Block Comments 


Syntax: 


47 comment 


A comment which begins with two semicolons inside a macro or a repeat 
block definition is called a macro/repeat block comment. Macro/repeat 
block comments do not appear in the expansion of the macro or repeat 
block. They are used to document the macro definition or repeat block 
without cluttering up the expansion listing with duplicate comments. For 
example, the following macro definition: 


define MACRO vall,val2 


DB vall ; this comment will show up 
DB val2 ;; this one won't 
ENDM 


will expand to: 


define re i 


0 
DB 0 ; this comment will show up 
DB 1 


10.8 LOCAL Directive 


neal le el arti pa Te etal a nn cesses ce 
Syntax: 


LOCAL formalparam, 


The LOCAL directive substitutes an automatically generated name of the 
form ??XXXX, where XXXX is a hexadecimal number, for formalparam 
each time the macro is expanded. If more than one formal parameter is 
given, they must be separated by commas. The LOCAL directive can only 
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be used within a macro definition block; it cannot be used within a repeat 
block. 
For example, given the macro definition: 


chk_err MACRO~ limit 
LOCAL skip 


cmp ax, limit 7; check value against 
sy 22mit 
jle skip $37 skip call if OK 
call error 7; call error procedure 
skip: 
ENDM 


The following macro invocations: 


chk_err 5 
chk_err 10 


will cause the following code to be expanded: 


cmp ax, 5 

jle ??0000 

call error 
??0000: 

cmp ax,10 

jle ??0001 

call error 
??0001: 


10.9 EXITM Directive 


Syntax: 


EXITM 


The EXITM directive terminates expansion of a macro or a repeat block 
immediately. For example, the following repeat block: 
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IRPC val, 0123456789 
IFIDN <val>,<3> 
EXITM 

ELSE 

DB val 

ENDIF 

ENDM 


will cause the following statements to be generated: 


DB 0 
DB 1 
DB 2 


Please see also: Conditional Assembly (8.4) 
PURGE Directive 


Syntax: 


PURGE name,... 


The PURGE directive has no effect and is present only so that no errors 
will be generated by PURGE statements in existing 8086 programs. 


Parameter Substitution 


Syntax: 


&formalparam 
formalparamé 
&formalparamé 


When a macro is expanded, 386! ASM substitutes actual parameters for 
each of the formal parameters in the macro definition. Each occurrence of 
a formal parameter name, which is separated from adjacent symbols by 
spaces, tabs, or the ampersand character (&), is replaced with its 
corresponding actual parameter. The ampersand may be placed on either 
side or on both sides of the formal parameter name and is removed along 
with the formal parameter name when the actual parameter is 
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substituted. It is also used to force parameter substitution inside a string 
constant. For example, the following repeat block: 


IRP val <0 i. 2 
var&val DB 'This value is &valé&' 
ENDM 


will expand to: 


var0 DB 'This value is 0' 
varl DB 'This value is 1' 
var2 DB 'This value is 2' 


If two formal parameters are placed adjacent to each other, they must be 
separated by two ampersand characters, in order to force substitution of 
both parameters. This happens because each substitution removes one 
ampersand character. This is true even if the formal parameters are 
parameters for two separate macros in nested macro expansions or repeat 
blocks. For example, the following macro definition with a nested repeat 


block: 
define MACRO a,b 
DB "a&&b' 
IRPC c,012 
a&&c DB b 
ENDM 
ENDM 


will expand to: 


define test 32 


DB 'test32' 
test0 DB Es 
testl DB 32 
test2 DB 32 


Please see also: Macro Expansions (10.3), IRPC (10.5), IRP (10.6), 
Conditional Assembly (8.4) 


ee eee ae pene 
10.12 Actual Parameter Lists 
Lists of actual parameters passed to macro expansions and lists of actual 


parameters for the IRP directive follow the same syntax. An individual 
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actual parameter is a string of characters that is terminated by a space, a 
tab, a comma, a semicolon, or a left angle bracket (<). In addition, there 
are special operators that are valid only in actual parameter lists to permit 
any character to become part of an actual parameter. 


Please see also: Macro Expansions (10.3), IRP (10.6) 


10.121 Literal Character Operator 


Syntax: 


'character 


The literal character operator (!) causes the next character to be treated as a 
literal character when the actual parameter list is processed. It can be used 
to escape characters that would normally have a special meaning 


(parameter separators or parameter list operators) to make them a part of 
the parameter. 


Example: 
define MACRO string 
DB "&éstring' 
ENDM 


define parameter! with! spaces 
DB ‘parameter with spaces' 


define a!;b; parameter with a ; in it 
DB ‘azb* 


define 0! !<! 1 ; escape < operator 


DB | ee 
define My! Gosh!! ; escape ! operator 
DB "My Gosh!'! 


10.12.2 Literal Text Operator 


Syntax: 


<text> 
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The literal text operator (<>) causes all the text within the angle brackets to 
be treated as literal text when the actual parameter list is processed. It 
creates a single actual parameter whose value is text. Any previous actual 
parameter on the line is terminated by the < character, and this actual 
parameter is terminated by the > character. Like the literal character 
operator, this operator can be used to escape separator characters in 
parameter lists. This operator should not be confused with the angle 
brackets which are required to surround the actual parameter list for the 
IRP directive (please see section 10.6). 


The only characters within angle brackets which are not treated as literal 
text are the other two parameter list operators (! and %) and any angle 
brackets. The ! and % operators are still active, and any angle brackets 
within the text must be matched (e.g., <abc<de>fg> yields a string 
“abc<de>fg”). If unmatched angle brackets are desired within the text, the 
literal character operator must be used (e.g., <abc!<defg> yields a string 
“abc<defg”). 
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define MACRO list 
DB List 
ENDM 
define <1,2,3> ; Escape comma separator 
DB igaes 

define MACRO strl,str2 
DB "éstrlé' 
DB "str2é&' 
ENDM 
define this< is a string with spaces> 
DB 'this' 
DB ' is a string with spaces' 
define this,< is a <string> with angle brackets> 
DB ‘this' 
DB ' ig a <string> with angle brackets' 
define this < is a string with a !>> 
DB ‘this* 
DB ' is a string with a >' 
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Expression Operator 


Syntax: 


S$expression 


The expression operator evaluates an expression to obtain a constant value, 
converts the value into an ASCII decimal string, and gives the actual 
parameter the resulting string as a value. The string that is evaluated as 
an expression is terminated by a comma, a semicolon, an exclamation 
point, a left or right angle bracket, or another percent character (i.e., one of 
the set ,;!<>%). 


Normally the expression operator can only be used to return a single 
actual parameter. It must be the first character in the actual parameter. If 
a % is encountered in a string of text, it is normally treated as any other 
text character. The exception to this rule is that the % operator is 
recognized anywhere within literal text enclosed in angle brackets (<>). 


Example: 
define MACRO val, string 
DB val 
DB ‘&string' 
ENDM 


define %1 + 2,=3 
DB a 
DB '=3! 


define % 1+ 2 $3+4 
DB 3 
DB ' 


define %3*4-2 <=10> 


DB 10 

DB '=10' 

define %3*4-2 !t=! 5 
DB 10 

DB tte 5! 


oe s1 + 2,<is equal to $1 + 2, right?> 
3 
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DB ‘is equal to 3, right?! 

define 1,99%o0f100 ; notice % within string 
; has no effect 

DB a 

DB "99%So0f100' 


String Operators 


Syntax: 


‘string 
"string" 


Single or double quotes may be used as string operators in an actual 
parameter to cause all characters within the quotes, including special 
characters such as spaces, commas, and other parameter list operators, to 
be treated as literal text. The string operators differ from the literal text 
operator in three ways: (1) The quotes that delimit the string are kept as 
part of the actual parameter. (2) All characters are treated literally within 
the string, including other parameter list operators. (3) The string 
Operators may be embedded in the text of an actual parameter; they do not 
automatically terminate the previous actual parameter and begin a new 
one. 


Example: 
define MACRO strl,str2 

DB stri 
DB 'str2é&' 
ENDM 
define "lot's! of <special>,chars%", 0 
DB "lot's! of <special>,chars%" 
DB ' 0 ' 


define 0, one" way to get "spaces 
DB 0 
DB 'one" way to get “spaces' 
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Programming the 80386 


This chapter describes some of the unique aspects of programming 
members of the 8086 processor family. A basic knowledge of assembly 
language programming and of the 80386 processor architecture is 
assumed. The purpose of this chapter is to aid someone who already 
knows how to write assembly language programs for other machines to 
quickly begin writing programs for the 80386. It is not a tutorial on how to 
program in assembly language. 


11.1 Real Mode Programming 


The 80386 has two primary modes of operation: real mode and protected 
mode. In real mode, the processor essentially looks like a fast 8086 
processor. Current versions of MS-DOS execute only in real mode, so the 
80386 processor is normally executing in real mode if the operating system 
is MS-DOS. This section discusses programs written to execute in real 
mode on the 80386 or 80286 (which also has real and protected modes of 
operation), and programs written to execute on an 8086, 8088, 80186, or 
80188 processor. To assemble and link a program in a source code file 
named HELLO.ASM for execution in real mode, type: 


386asm hello -8086 
386link hello -8086 


This assembles the source file HELLO.ASM to create an object file 
HELLO.OBJ and a listing file HELLO.LST, and then links the object file to 
create an executable task image HELLO.EXE and a map file HELLO.MAP. 


An important feature of the 8086 family architecture is the concept of 
segmentation. In real mode, a program is partitioned into segments, each 
of which may be up to 64 kilobytes (KB) in length. The processor has a 
special set of registers, called segment registers (please see Appendix F), 
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which must be set up to point to a segment before data or code in the 
segment can be accessed or executed. 


In real mode, a segment register contains the paragraph address of a 
segment, where a paragraph is a 16 byte boundary within the address 
space. A full address within a segment is given by the segment paragraph 
address and by an offset (from 0 to 64 KB) within the segment. The 
processor creates an internal 20 bit address from this by shifting the 
segment address left four bits, turning it into a byte address, and then 
adding it to the offset within the segment. Note that this method of 
creating an internal address limits the address space of the processor in 
real mode to one megabyte (an internal address is 20 bits wide). For 
reasons discussed in the next section, we call the value in the segment 
register a segment selector; and we call the internal address created by the 
processor from the segment selector and the segment offset a linear 
address. On the 8086, 8088, 80186, 80188, or on the 80286 or 80386 executing 
in real mode, the linear address is always the same as the physical address 
that the processor puts out on the address bus to access the memory. 


Specific segment registers are assumed for specific operations performed 
by the processor. The CS register is assumed (by the processor) to point to 
the current code segment; the DS register is assumed to point to the 
current data segment, the SS register to the current stack segment, and ES, 
FS, and GS point to extra data segments. Most programs must have CS, 
DS, and SS set up to point to valid segments in order to execute. It is not 
necessary to set up ES, FS, or GS unless the program makes specific use of 
them. 


For every memory reference made by the processor, there is a default 
segment register to compute the internal memory address. For 
instruction fetch operations, CS is assumed. For data references, DS is 
assumed. For stack operations (e.g., PUSH, POP, and indirect references 
using the EBP or ESP register) SS is assumed. ES is only assumed for the 
destination of some string operations, and FS and GS are never assumed. 
Please see Appendix D and the list of related documents in the the list of 
related documents in the Preface for specific details on which operations 
assume which segment registers. 


It is possible to override the segment register that the processor uses for a 
memory reference on an individual instruction by prefixing the 
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instruction opcode with a segment override byte. This is done 
automatically by 386! ASM for memory references which do not obey the 
defaults used by the processor. For example, a data reference to a variable 
in the segment pointed to by CS would have a segment override byte to 
tell the processor to use the CS register instead of the DS register in 
computing the variable’s address. Obviously, in order to correctly 
generate override bytes, 386! ASM must know which segments are 
pointed to by which segment registers. This is done with the ASSUME 
directive (please see section 3.10) and is a necessary part of an assembly 
language source code file. 


When a program is loaded for execution by MS-DOS, the CS segment 
register is initialized by the program loader to point to the code segment 
where execution begins. The DS register is initialized by the loader to 
point to a block of information about the program (not to the program’s 
data segment). Initalizing DS to point to its data segment is usually the 
first operation performed by the program when it begins execution. In 
addition, all segments with a combine type of STACK (please see section 
3.7.2) are combined by the linker into a single segment. The loader 
initializes SS to point to this segment, and SP (the stack pointer) to point 
to the highest offset within the segment (the stack grows downward in the 
8086 family). If there is no segment in the program with a STACK 
combine type, SS and SP will not be initialized by the loader; it is then the 
responsibility of the program to initialize those registers as well as DS. 


Typically, an application program will have three segments: a code 
segment, a data segment, and a stack segment. Frequently, the stack and 
data are combined into a single segment which is pointed to by both DS 
and SS, with the data at the bottom of the segment and the stack at the top 
of the segment. In simple programs, it is even possible to have only one 
segment, with CS, DS, and SS all pointing to the same segment. 


Large programs may require more than one data segment, or more than 
one code segment, or both. (Remember that a single segment in real 
mode is limited to 64 KB in length.) Multiple data segments are handled 
either by setting up DS to point to whichever data segment you need to 
access, or by keeping DS pointing at the main data segment and using the 
extra data segment registers ES, FS, and GS to access the other data 
segments. Remember that every time a segment register is reloaded with 
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a new value, 386! ASM must also be informed of the change with the 
ASSUME directive so that it can generate correct code! 


Multiple code segments are handled by having two forms of call and 
jump instructions: a NEAR call or jump, and a FAR call or jump. NEAR 
control transfers are within the segment currently pointed to by the CS 
register and have an offset within the segment as an operand to the 
instruction. FAR control transfers are to another segment and have as 
operands both a segment selector (in real mode, the segment paragraph 
address) and an offset within the new segment. When the FAR call or 
jump is executed, the processor loads CS with the new segment selector 
given by the instruction. 386!1ASM automatically generates the correct 
form for a call or jump instruction. It determines which form to use from 
the data type (NEAR or FAR) of the label or procedure which is the 
destination of the call or jump (please see sections 5.2 and 5.3.1). Note that 
there are also two forms of the return instruction. 386! ASM generates the 
correct form by generating a FAR return within a FAR procedure, and a 
NEAR return within a NEAR procedure. Once again, an ASSUME 
directive must be placed before each code segment in an assembly 
language source file to tell 386! ASM that the CS register will point at that 
segment during program execution. 


Note that the only legal way to change the contents of the CS register is 
with a FAR call or jump, or with one of the return instructions which 
pops the CS register. The two return instructions which pop the CS 
register are the FAR form of the RET instruction, and the return from 
interrupt (IRET) instruction. 


The following simple example program demonstrates some of these 
concepts. It performs an MS-DOS system call to output the message 
“Hello world.....” on the terminal when it is executed. This program has 
three segments: a code segment which is pointed to by the CS register, a 
data segment which is pointed to by the DS register, and a stack segment 
which is pointed to by the SS register. Since the program does not use the 
ES, FS, and GS registers, it does not even bother to initialize them. At first 
glance, it may appear that this program is so simple that it does not even 
use the stack segment. In fact, the INT (software interrupt) instruction 
pushes a flags word and a return address on the stack. Hardware 
interrupts during normal CPU operation also require space on the stack 
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for a return address. Thus, every program must set up the SS and SP 
registers to point to a valid stack area in memory. 


TITLE hello.asm 


; The .8086 directive can be used instead of the 
; -8086 command line switch to cause programs to 
; be assembled for execution in real mode on the 
; 80386 or 80286, or for execution on the 8086, 
; 8088, or 80186. The -8086 command line switch 
; must still be used with the linker, however! 


. 8086 


; Tell the assembler which segments the CS, DS, 
; and SS registers will point to 


ASSUME cs:cseg,ds:dseg,ss:sseg 


; Align the data segment on a paragraph (16 byte) 
; boundary and give it the standard combine type 
; OF PUBLIC. 


data SEGMENT PARA PUBLIC 'DATA' 


; Message to be output, formatted as required by 
; the MS-DOS system function call 

hellomsg DB "Hello world..... ', 0ODh, OAh, '$' 
data ENDS 

; Allocate 1000 bytes in a segment with a 

; combine type of STACK, which will cause the 

; loader to initialize SS to point to it, 


; and initialize SP to the highest offset. 


sseg SEGMENT PARA STACK 'STACK' 
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DB 1000 DUP (?) 
sseg ENDS 


; Also give the code segment the standard 
; combine type of PUBLIC. 


cseg SEGMENT PARA PUBLIC 'CODE' 


; The actual code to be executed is in 
; a NEAR procedure. 


print PROC NEAR 


; Initialize DS to point to the data segment 
mov ax, dseg 
mov ds,ax 


; Load the offset within the segment pointed 
; to by DS of the message to be output, load 
; the MS-DOS function code into AH, and trap 
; to the operating system to output the 

; message to the terminal. 


mov ah, 09h 
mov dx, OFFSET hellomsg 
int 21h 


; Load the MS-DOS terminate process function 
; code, and trap to the operating system 


“se 


mov ah, 4ch 
int 21h 


print ENDP 
cseg ENDS 


; Identify the entry point of the program 
; where the loader will transfer control after 
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; it loads the program and initializes the 
; CS, SS, and SP registers. 


. 
’ 


END print 


This is a complete program. On 80386, 8086, 8088, or 80286 systems 
running MS-DOS, you can create a file with this code in it, assemble and 
link it, as shown in the example at the beginning of this section, and then 
execute it to see it write the message “Hello world.....” on your terminal. 


Other than segmentation, the only feature of the 8086 processor family 
that is not in common use on most other processors is the use of 
dedicated registers by some instructions. For most instructions, the 
general registers (please see Appendix F) can be used interchangeably. 
However, some instructions assume that specific registers contain 
operands for the instruction. For example, the CX register contains a 
count operand for some string instructions. The AX, BX, and DX registers 
also have specialized uses for certain instructions. Instructions which 
dedicate certain registers for specific uses are identified in Appendix D and 
in the list of related documents in the Preface. 


11.2 Protected Mode Programming 


Protected mode is the mode of operation that permits use of the full 
power of the 80386. It allows access to a much larger address space, 
permits individual segments to be much larger (thereby eliminating the 
difficulties of dealing with multiple segments for large programs), and 
supports 32 bit wide operands for arithmetic operations and use of the 32 
bit wide register set of the 80386. To assemble and link a simple program 
in a file called HELLO.ASM for protected mode operation on the 80386, 
type the following commands: 


386asm hello 
386link hello 


The main difference between real mode and protected mode on the 80386, 
from the point of view of the application program, is the way in which 
segmentation is handled. In protected mode, an offset within a segment is 
32 bits wide, so a single segment can be up to four gigabytes long. 

Segments are controlled by two kinds of tables that are maintained by the 
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operating system: a global descriptor table (GDT), of which there can only 
be one per system; and a local descriptor table (LDT), of which there can be 
one per process (and therefore many in a multiprocessing system). A 
segment register contains a value called a segment selector, which 
contains a bit which selects either the GDT or the LDT for the current 
process. Two bits are used to control access to privileged segments, and 13 
bits are used to index to an entry in the selected descriptor table. A GDT or 
LDT can therefore contain up to 8192 entries. Each entry is eight bytes in 
size, and gives the starting address for the segment, and the size of the 
segment. It also gives status information which identifies the segment as 
either a code or a data segment, and identifies the privilege level of the 
segment, etc. Please see the list of related documents in the Preface fora 
complete description of how segmentation is handled in protected mode. 


A linear address in protected mode is created by the processor from the 
segment selector and the offset within the segment as follows: The 16 bit 
wide segment selector value (in the segment register) is used to identify 
an entry in one of the descriptor tables. This entry gives a 32 bit wide 
linear base address for the segment. The segment base address is then 
added to the 32 bit wide segment offset to yield a 32 bit wide linear address. 
The processor does some internal caching of descriptor table entries to 
speed up this process, but this is invisible to the programmer. 


The 80386 processor also supports paging on the chip. This is the reason 
the address formed from the segment selector and segment offset is called 
a linear address rather than a physical address. Paging can be disabled in 
protected mode, in which case the linear address is the same as the 
physical address the processor puts out on the address bus. If paging is 
enabled, the paging unit on the chip will translate the 32 bit wide linear 
address into a 32 bit wide physical address. This is invisible to the 
programmer and can be ignored; for a complete description of paging, 
please see the list of related documents in the Preface. 


Protected mode segments must be designated as either code segments or 
data segments. Code segments may not be written to, and code in data 
segments may not be executed. It therefore appears that any protected 
mode program must have at least two segments: a code segment and a 
data segment. In fact, it is possible to have a program with a single 
segment by creating two entries in the descriptor table for a single 
segment. One entry identifies the segment as a code segment, and the 
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other identifies the segment as a data segment. The CS register is loaded 
with the selector for the code segment entry in the descriptor table, and 
the DS register is loaded with the selector for the data segment entry. 


The important differences between protected mode and real mode, from 
the point of view of the application programmer, can be summarized as 
follows: 


1. The value in a segment register is no longer an address, as it is in real mode. 
Instead, it is an index to an entry describing the segment in a descriptor table. 


2. An offset within a segment is 32 bits wide, instead of 16 bits wide. An individual 
segment can therefore be up to four gigabytes in length, as opposed to 64 
kilobytes in real mode. 


3. A linear (and a physical) address is 32 bits wide, versus 20 bits wide in real 
mode. Up to four gigabytes of memory therefore can be directly addressed in 
protected mode, as opposed to one megabyte in real mode. 


4. Operands to instructions can be 32 bits wide. (This is important for arithmetic 
operations in particular). A 32 bit wide set of general registers is available 
(please see Appendix F). 


The following simple program is written to execute in protected mode on 
the 80386. It is the HELLO.ASM program from the example above, 
adapted a bit for protected mode. The basic differences are that the 
segments are set up as USE32 segments (this is the default for the 80386, 
and its meaning is described below the example program), and a couple of 
contrived instructions in the program show off the use of 32 bit registers 
and an instruction added for the 80386. 


TITLE hello.asm 


The .386c directive is actually unnecessary, 
since it is the default for 386|ASM. 


7e Se Fe Fe 


-386c 


ASSUME cs:cseg,ds:dseg,ss:sseg 


; We give the segments a use type of USE32 (the 
; default for the 80386). 
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LL 


data SEGMENT PARA PUBLIC USE32 'DATA' 


hellomsg DB "Hello world. ..+» *, ODh, Oak, *3* 
data ENDS 
sseg SEGMENT PARA STACK USE32 'STACK' 
DB 1000 DUP (?) 
sseg ENDS 
cseg SEGMENT PARA PUBLIC USE32 'CODE!' 


print PROC NEAR 


se 


; currently, programs linked by 386|LINK to 

; execute in protected mode are set up with a 

; single segment, and 386|DOS-Extender initializes 
; all segment registers to point to it. There is 
; therefore no need to initialize DS ina 

; protected mode program. 


; Although it is unnecessary, we use the 32 bit 
; registers and a protected mode instruction here 
; to load the MS-DOS function code into AH. 


mov al,09h ; load function code into AL 
xor ebx,ebx ; clear EBX to shift in 0's 
shld eax,ebx,8 ; shift code into AH 

mov dx,OFFSET hellomsg 


int 21h ; call MS-DOS 
mov ah, 4ch 
int 21h ; terminate process 


print ENDP 
cseg ENDS 


END print 


As noted above, there is currently no version of MS-DOS available which 
supports protected mode operation on the 80386. Phar Lap Software 
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provides a product, called the 386 | DOS-Extender, which allows programs 
written to execute in protected mode to execute under the control of MS- 
DOS, with full availability of MS-DOS system services. Please see the 
386 | DOS-Extender Reference Manual for full details. 


The 80286 processor also has a protected mode of operation. It is similar to 
the 80386 protected mode: There is a GDT and an LDT, and the segment 
selectors are the same. However, with the 80286, the segment offset is still 
only 16 bits wide. The segment base address and the linear and physical 
addresses formed from the segment selector and offset are 24 bits wide, 
giving an address space of 16 megabytes in 80286 protected mode. 


As part of Intel’s policy of upward compatibility in the 8086 family, the 
80386 provides a way of executing programs written for 80286 protected 
mode without modification. They provide the concept of a use type 
(please see section 3.7.3) on a segment. A segment is designated as either a 
USE16 or a USE32 segment and is identified as such in the descriptor table 
entry for the segment. USE32 segments are the default and operate as 
described above. USE16 segments are provided for compatibility with the 
80286. Offsets within USE16 segments are 16 bits wide, so the maximum 
segment size is 64 KB. Instruction operands are assumed to be 16 bits 
wide, instead of the default of 32 bits wide in USE32 segments. Stack 
segments with the USE16 attribute use the SP register instead of the ESP 
register on PUSHs and POPs. It is still possible to use the 32 bit wide 
register set and manipulate 32 bit wide memory operands from USE16 
segments, but instructions that do so must be prefixed by override bytes. 
386 | ASM automatically generates operand size and address size override 
bytes as necessary in USE16 segments. 


In general, USE16 segments should never be used with programs written 
for 80386 protected mode. They should be used only for programs 
originally written for 80286 protected mode and then ported to the 80386. 
Unfortunately, it is possible to write programs that mix the use of USE16 
and USE32 segments. Although this is not advised, if you do so, there are 
certain rules to follow for control transfers between USE16 and USE32 
segments. Please see Appendix J for details. 
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11.3 Using the 80386 in Real Mode 


Even when the 80386 is executing a program in real mode, it is possible to 
use the 32 bit register set and the new instructions that were added for the 
80386. Access to the 32 bit registers and addressing modes is obtained by 
prefixing instructions with an override byte. The new instructions are 
automatically recognized and executed by the processor, even when it is 
executing in real mode. Note that there is no way to get around the 
segment size limit of 64 KB imposed in real mode. 


To force 386! ASM to assemble the 80386 instructions, the program must 
be assembled with the 80386 as the target machine (the default). To force 
override bytes to be generated for 32 bit instruction operands, the segment 
must be designated a USE16 segment. The program is linked with the 
8086 as the target machine, as usual for a real mode program. Thus, to 
assemble and link a program for execution in real mode, but still use the 
32 bit register set and the new instruction set, enter the following 
commands: 


386asm hello 
386link hello -8086 


We again modify our example program to demonstrate how the 32 bit 
registers, etc., can be accessed from a program that executes in real mode. 
The only difference between this program and our sample protected mode 
program is that the segments are now USE16 segments, so that code that 
can be executed in real mode is generated. 


TITLE hello.asm 
.386c ; assemble for protected mode 
ASSUME cs:cseg,ds:dseg,ss:sseg 

; We give the segments a use type of USE16, so 

; that the assembler will generate override bytes 


; to allow us to access 32 bit operands. 


data SEGMENT PARA PUBLIC USE16 'DATA' 
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hellomsg DB 
data ENDS 
sseg SEGMENT 
DB 
sseg ENDS 
cseg SEGMENT 
print PROC 
mov 
mov 
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"Hello world..... *, ODh, OAh, *5* 


PARA STACK USE16 'STACK' 


1000 DUP (?) 


PARA PUBLIC USE16 'CODE' 
NEAR 


ax, dseg 
ds,ax 5 Tale Bs 


; As in the protected mode program, we use 32 bit 

; registers and the new instruction SHLD. However, 
; the code generated will be different; since we 

; are in a USE16 segment, we will get operand size 
; override bytes for the 32 bit operands. 


mov 
xOr 
shld 
mov 
int 


mov 
int 


print ENDP 
cseg ENDS 


END 


al,09h ; load function code into AL 
ebx,ebx ; clear EBX to shift in 0's 
eax,ebx,8 ; shift code into AH 
dx,OFFSET hellomsg 


21h" ; call MS-DOS 

ah, 4ch 

21h ; terminate process 
print 
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386| ASM Command Line 


filel, FileZ,, ««7#fiLen 
-LIST file 

-NOLIST 

-ERRORLIST file 

-OBJECT file 

-NOOBJECT 

-8086 -80186 -80286 -80386 
-80286P -80386P 


-NO87 -8087 -80287 -80387 
-INCLUDE path 

-DEFINE name[=string] 
-NOSYM 

-NODELETE 

-ONECASE -TWOCASE 
-FULLWARN 


Switches 


Input file names 

Listing file name 

Suppress listing file 

Produce error listing file 

Object file name 

Suppress object file 

Select target CPU 

Select CPU with protected 
instructions 

Select target numeric coprocessor 
Set INCLUDE directive path 
Define a text symbol 

Suppress symbol table in listing 
Produce object file even if errors 
Set case of symbols 

Enable extra error checking 
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Error Messages 


If an error occurs during assembly of a program, 3861 ASM displays an 
error message on the screen which identifies the source code file in which 
the error occurred, the statement line number within the file, an error 
number identifying the error, and a message describing the error. The 
same message is also written to the .LST file. 


Assembler errors are divided into three categories: (1) Error numbers less 
than 1000 are used to identify warning errors. Warning errors are errors 
that do not necessarily cause the assembler to generate invalid object code 
for the statement in error. (2) Error numbers greater than 1000 and less 
than 2000 are used to identify severe errors. Severe errors are errors 
which cause the assembler to be unable to generate correct object code for 
the statement. (3) Error numbers greater than 2000 are fatal errors. Fatal 
errors cause the assembler to terminate immediately, without processing 
the rest of the source code file. Fatal errors are only written to the listing 
file if they occur on pass 2 of the assembly. 


The three sections below list the warning errors, severe errors and fatal 
errors that occur in 3861 ASM. Probable causes and possible solutions for 
the errors are also listed. Errors are listed in numerical order. 


B.1 Warning Errors 


WARNING 1: Syntax error - name ignored by directive 


Cause: A user-defined name was given to a directive that does 
not use names. 


a 
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WARNING 2: Can't close listing file: filename 

WARNING 3: Can't close object file: filename 

WARNING 4: Can't close error list file: filename 

WARNING 5: Can't close cross-reference file: filename 
Cause: 1. The disk is full. 


2. MS-DOS resident code has been corrupted. 


Solution: 1. Delete files to free up space on the disk. 
2. Reboot the system. 


WARNING 6: Can't close source file: filename 

WARNING 7: Can't close include file: filename 

Cause: MS-DOS resident code has been corrupted. 

Solution: Reboot the system. 

WARNING 8: Source line too long - truncated 

Cause: The source line exceeded 132 characters and was truncated 


to 132 characters. 


Solution: Shorten the source code line. 


WARNING 9: at character number n: Illegal printing 
character - ignored 


Cause: A printing character which is not part of the character set 
recognized by the assembler was encountered and was 
treated as a space. 
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WARNING 10: 


Cause: 


WARNING 11: 


Cause: 


WARNING 13: 


Cause: 


WARNING 14: 


Cause: 


WARNING 15: 


Cause: 


at character number n: Illegal non-printing 
character - ignored 


A non-printing character other than a space, carriage 
return, line feed, horizontal tab, or form feed was 
encountered and was treated as a space. 


at character number n: character used in 
illegal context - ignored 


A character was used in an illegal context and was treated 
as a space. 


String not terminated 


The end quote on a string constant is missing. 


Missing ENDIF for conditional block 


The ENDIF required to terminate a conditional block is 
missing. 


Missing ENDM for macro definition 


The ENDM required to terminate a macro definition or a 
repeat block is missing. This caused all the rest of the 
lines in the source file to be treated as part of the macro 
definition. 
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WARNING 16: Integer overflow 


Cause: A constant or constant expression is too large for a 
particular data type. 
Solution: Change the data type or give the constant a smaller value. 


WARNING 17: Floating point overflow 


Cause: A floating point constant is too large for a particular data 
type. 
Solution: Change the data type or give the constant a smaller value. 


WARNING 18: Floating point underflow 


Cause: A floating point constant is too small for a particular data 
type. 
Solution: Change the data type or give the constant a larger value. 


WARNING 19: Decimal point following hexadecimal digits 


Cause: A decimal point may only be used with decimal digits. 


WARNING 20: Macro purged or redefined within itself: 


macroname 

Cause: A macro purged or redefined itself. This is legal for 
compatibility with Microsoft, but it is a somewhat dubious 
practice. 

Solution: Either ignore the warning, or fix the macro definition. 


i es er Sr 
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WARNING 21: 


Cause: 


Solution: 


WARNING 22: 


Cause: 


WARNING 23: 


Cause: 


WARNING 24: 


Cause: 


WARNING 25: 


Cause: 


Digits too large for radix - base 16 
assumed 


One or more digits in a constant were too large for the 
current default radix, or for the radix specified with a radix 
designator character at the end of the constant. 


Fix the number or add a radix designator at the end of the 
constant. 


Unmatched ENDM 


An ENDM was encountered for which there is no 
matching MACRO, IRP, IRPC, or REPT. 


Extra characters on line 


After all the operands for a directive or instruction were 
processed, there were still more characters on the source 
line. 


Illegal use of symbol in expressions: 
symbol 


Either a user-defined symbol or an assembler reserved 
word was used illegally in an expression. 


Divide by zero 


A divide by zero was attempted in an expression. 
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WARNING 26: Reference to multiply defined symbol: 
symbolname 


Cause: The statement references a symbol that is defined more 
than once elsewhere in the source code file. 


Solution: Remove all but one of the symbol definitions. 


WARNING 27: No IF to match ELSE or ENDIF 


Cause: An ELSE or ENDIF statement was encountered when 
there was no active conditional block. 


WARNING 28: Two ELSEs in a row 


Cause: Two ELSE directives were encountered in succession with 
no ENDIF or IF statement between them. 


WARNING 29: Floating point denormal value generated 


Cause: The floating point number is so small it is a denormal 
value in the specified data type. 
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Cause: 


Solution: 


WARNING 31: 


Cause: 


Solution: 


Error Messages 


Constant definition will not retain its 
data type 


An absolute expression which followed an equal sign (=) 
directive had a data type which was ignored. The symbol 
name which preceded the directive was entered into the 
symbol table as an absolute constant without a data type. 


If the absolute constant does not need to have a data type 
associated with it, remove the data type specifier from the 
expression. If the data type is required, the constant can be 
entered in the symbol table as a text substitution by using 
the EQU directive instead. 


Instruction shortened, NOPs inserted 


A forward reference in the instruction caused more space 
to be allocated on pass one than was necessary on pass 
two. The unused space was padded out with NOP 
instructions. (This error is only reported when the - 
FULLWARN switch is used.) 


Remove the forward reference that caused the warning, or 
give the assembler more information about the forward- 
referenced symbol by using the PTR and/or segment 
override operators. 
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WARNING 32: 


Cause: 


Solution: 


WARNING 33: 


Cause: 


B.2 Severe Errors 


ERROR 1002: 


Cause: 


ERROR 1003: 


Cause: 


172 


Default segment register has no assumption 


The indirect address modes imply a segment register 
which is used as a base when the effective address of the 
operand is calculated. If the segment register implied by 
the address mode has no assumption, 386! ASM will flag a 
WARNING error to inform the programmer that a 
segment register which has no assumption has been used. 


Use the ASSUME directive to inform the assembler what 
value the segment register will have when the instruction 
is executed. 


Value combined with segment selector 
ignored 


A segment selector value (obtained by using a segment 
name or the SEG expression operator) was combined with 
a constant value. When the program is loaded for 
execution, the value will be replaced with the segment 
selector value, and the constant value will be discarded. 


Syntax error 


There was a syntax error in the statement. 


Syntax error - instruction expected 


Something other than an instruction followed an 
instruction label. 


TE 
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ERROR 1004: 


Cause: 


ERROR 1005: 


Cause: 


ERROR 1006: 


Cause: 


Solution: 


ERROR 1007: 


Cause: 


Solution: 


ERROR 1008: 


Cause: 


Syntax error - directive expected 


Something other than a directive followed a user-defined 
symbol. 


Syntax error - missing argument 


A required argument for a directive is missing. 


Can't open include file: filename 


1. Invalid file name. 
2. Access denied to the file. 


1. Correct the spelling of the file name. 
2. Clear up the access problem. 


Can't open include file, path too long: 
filename 


The file name specified in the INCLUDE statement plus 
the path name specified in the command line together 
added up to more than 255 characters. 


Move the include file so that the path name can be made 
shorter. 


Syntax error - missing name for directive 


A directive that requires a user-defined name is missing 
the name. 
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ERROR 1009: Illegal statement - no current segment 


Cause: A statement that is only legal within a segment was 
encountered when no segment was open. All 
instructions and many directives must be inside a 
segment. 


ERROR 1010: Symbol already a reserved word: symbolname 


Cause: Attempt to create a user-defined symbol with the same 
name as one of the assembler reserved words. 


ERROR 1011: Symbol already different kind: symbolname 


Cause: Attempt to redefine a previously defined symbol. 


ERROR 1012: Segment parameters are changed 


Cause: Attempt to re-open a segment with different segment 
attributes than those used for its definition. 


ERROR 1013: Count for DUP operator cannot be relocatable 


Cause: Only constant values may be used for the count parameter 
with the DUP operator. 


ERROR 1014: Improper segment attribute specifier. 


Cause: One or more of the keywords following a segment 
directive is not a valid segment attribute specifier. It must 
be an align type, combine type, access type or use attribute 
keyword (e.g., BYTE, PUBLIC, ER, USE16). 


er Se 
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ERROR 1015: 


Cause: 


ERROR 1016: 


Cause: 


ERROR 1017: 


Cause: 


ERROR 1018: 


Cause: 


ERROR 1019: 


Cause: 


ERROR 1020: 


Cause: 


Solution: 


Block nesting error 


An attempt was made to re-open a segment that is already 
open, or an ENDS directive was encountered for a 
segment or structure which is not currently open. 


Open procedure: procname 
The procedure named procname was opened with the 


PROC directive but never closed with a corresponding 
ENDP directive. 


Undefined symbol: symbolname 


A symbol that was never defined was referenced. 


Open segment: segname 


The segment named segname was opened with the 
SEGMENT directive but never closed with a 
corresponding ENDS directive. 


Symbol multiply defined: symbolname 


Attempt to redefine a symbol that has been previously 
defined. 


Segment already in a different group: segname 


Attempt to put the segment segname into more than one 


_ group. 


Remove segname from all group definitions except one. 


a 
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ERROR 1021: 


Cause: 


Solution: 


ERROR 1022: 


Cause: 


ERROR 1023: 


Cause: 


Solution: 


ERROR 1024: 


Cause: 


ERROR 1025: 


Cause: 
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Syntax error - invalid expression 


The expression does not obey the rules for forming a legal 
expression. 


Check the operator precedence table and look for typing 
mistakes. 


DUP operator requires count on left 


An absolute count is required to the left of the DUP 
operator in data declaration statements. 


DUP operator nested too deeply 


DUP operators were nested greater than 17 levels deep ina 
data declaration directive. 


Find a simpler way to declare the data. 


Unknown symbol type specifier 


A directive which requires a symbol type keyword (e.g, 
BYTE, NEAR) has not found one. 


Type illegal in context 


The symbol type keyword used with the directive is not 
valid given the context of the statement. 
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Cause: 


Solution: 


ERROR 1027: 


Cause: 


Solution: 


ERROR 1028: 


Cause: 


Solution: 


ERROR 1029: 


Cause: 


ERROR 1030: 


Cause: 


Error Messages 


No or unreachable CS 


A NEAR procedure has been defined when the CS register 
is assumed to be pointing at a different segment. 


Use the ASSUME directive to tell the assembler that CS 
will be pointing at the current segment before defining a 
NEAR procedure. 


Procedure not open: procname 


An ENDP directive was encountered for a procedure 
which is not currently open. 


Remove the useless ENDP directive. 


Procedure nesting error, closing: procname 


An ENDP directive was encountered for a procedure other 
than the most recently opened one, causing the most 
recently opened one to be closed. 


Correctly order the PROC/ENDP directives for each 
procedure. 


Procedure closed in different segment: procname 


The named procedure was opened in one segment and 
closed in another. 


Constant was expected 


A relocatable value was used when only a constant value 
is permitted. 
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ERROR 1031: 


Cause: 


ERROR 1032: 


Cause: 


Solution: 


ERROR 1033: 


Cause: 


ERROR 1034: 


Cause: 


Solution: 
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Module already has title 


Two TITLE directives were encountered. Only one is 
permitted per module. 


Can't use EVEN on byte segment 


The EVEN directive was used in a segment with a byte 
align type. Since the assembler can’t know whether the 
segment will reside on an even or an odd byte boundary, 
it is unable to decide whether or not to generate a pad byte. 


Change the align type of the segment or remove the 
directive. 


Value is out of range 


The value is too large or too small for the data type either 
explicitly specified or implied in the statement. 


Illegal forward reference to symbol: symbolname 


The forward reference to the specified symbol is illegal, 
because the assumptions made by the assembler about the 
symbol on pass one caused less object code to be generated 
than on pass 2. 


Use operators, such as segment override or PTR, to give 
the assembler more information about the forward 
referenced symbol; or move the symbol declaration in 
front of the statement that references it. 
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ERROR 1035: 


Cause: 


ERROR 1036: 


Cause: 


Solution: 


ERROR 1037: 


Cause: 


Solution: 


ERROR 1038: 


Cause: 


Solution: 


Syntax error - bad data type in expression 


One of the constant data types other than integer (e.g., 
packed decimal, real number, quadword integer) was used 
with the wrong data declaration directive (DB, DW, DQ, 
DP, DT). 


Symbol already defined external: 
symbolname 


An attempt to locally define an external which has already 
been referenced in the module. An external can only be 
redefined locally if has not been used yet. 


Remove the local definition or remove all the references 
above it. 


Symbol not defined external: symbolname 


A symbol was declared both public and external in a 
module and the public definition took precedence. 


Remove the external declaration. 


TS 
Symbol already defined locally: symbolname 


An attempt to declare as external a symbol which has 
already been defined locally. 


Remove the EXTRN definition for the symbol. 


oe 
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De ee ee ee ee, 


ERROR 1039: 


Cause: 


ERROR 1040: 


Cause: 


ERROR 1041: 


Cause: 


ERROR 1042: 


Cause: 


ERROR 1043: 


Cause: 


ERROR 1044: 


Cause: 


180 


Local and external definitions Gitter £6z: 
symbolname 


The symbol data type given in the external declaration for 
a symbol does not match its local definition. 


NS $$ 


Symbol type illegal for PUBLIC: symbolname 


A symbol other than a variable, label, or constant was 
used in a PUBLIC definition. 


ee er 
Segment override is illegal 


A segment override is illegal in the context of the 
statement. 


Improper operand type 


The data type of the operand is illegal for the instruction 
or directive. 


LT 
Operand types don't match 


Two or more operands of an instruction or directive have 
incompatible data types. 


ee ee 
Circular text substitution: symbolname 


The specified symbol name is a text substitution symbol 
which, if expanded, would cause a circular text 
substitution. 


nA Rien en Rt = eee 
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Cause: 


ERROR 1046: 


Cause: 


ERROR 1047: 


Cause: 


ERROR 1048: 


Cause: 


ERROR 1049: 


Cause: 


ERROR 1050: 


Cause: 


ERROR 1051: 


Cause: 


Error Messages 


Multiply defined symbol: symbolname 


The symbol is defined in more than one place in the 
source program. 


Missing ) 


There was a “(” with no matching “)” in an expression. 


Missing ] 


There was a 


“{” with no matching “]” in an expression. 


Invalid use of relocatable operand 


A relocatable value was combined in an illegal fashion 
with an expression operator. 


Invalid use of segment override 


The expression attempted to combine two values with 
overrides to different segments. 


Incompatible data types in expression 


The expression attempted to combine two values with 
different data types. 


Illegal use of register 


A register name was used illegally in an expression. 


————— 
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ERROR 1052: 


Cause: 


ERROR 1053: 


Cause: 


Solution: 


ERROR 1054: 


Cause: 


ERROR 1056: 


Cause: 


Solution: 


ERROR 1057: 


Cause: 
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Illegal constant value for expression 


One of the constant data types other than integer (e.g., 
packed decimal, real number, quadword integer) was used 
with an operator other than unary + or unary -. 


Operand must have size 


The assembler must know the size of the operand(s) to an 
instruction in order to generate correct object code. 


Specify the size of the operand(s) with the PTR operator. 


Illegal addressing mode 


An illegal addressing mode for the instruction was used. 


Can't reach with segment register 


A memory reference operand cannot be referenced with 
any of the currently assumed segment register values. 


Use the ASSUME directive to tell the assembler which 
segment register will point at the operand’s segment at 
runtime. 


Illegal scale factor for index register 


A scale factor other than one, two, four, or eight was used 
with an index register. 
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ERROR 1059: 


Cause: 


ERROR 1060: 


Cause: 


Solution: 


ERROR 1061: 


Cause: 


ERROR 1062: 


Cause: 


ERROR 1063: 


Cause: 


ERROR 1064: 


Cause: 


ST(n) 8087 register out of range 


A value outside the range zero—seven was used to identify 
one of the 8087 floating point stack registers. 


Text substitution (from EQU) caused 
buffer overflow - line truncated 


The source statement contains references to one or more 
text substitution symbols which, when expanded, caused 
the assembler’s internal buffers to overflow, forcing it to 
truncate the internal representation of the statement. 


Break up the statement into two or more statements. 


Near JMP/CALL to different CS 


A near JMP or CALL was attempted to a label in another 
segment. 


AT combine value must be last on line 


No segment attribute may be given following the AT 
combine type specifier with the SEGMENT directive. 


Relative value out of range 


A PC-relative value is greater than 127 or less than -128. 


Wrong number of digits in hexadecimal real 


A hexadecimal encoded real number does not have either 
8, 16 or 20 digits. 
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ERROR 1065: Illegal packed decimal number 


Cause: A packed decimal number has more than 18 decimal 
digits, or has digits (i.e., A-F) that are too large for base 10. 


ERROR 1066: Syntax error - no expression following % operator 


Cause: The % operator in a macro invocation statement was not 
followed by a valid expression. 


ERROR 1067: Missing END directive added by assembler 


Cause: The source file did not contain an END statement. The 
assembler inserted an END statement following the last 
line in the last source file of the assembly. 


ERROR 1068: Statement only valid inside macro 


Cause: The LOCAL or EXITM directives were encountered 
outside a macro definition. 


ERROR 1069: SHORT operator only valid for label 


Cause: The SHORT expression operator was used with a value 
other than an instruction label. 


ERROR 1070: Missing > 


Cause: A “<” with no matching “>” was encountered. 
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ERROR 1071: 


Cause: 


Solution: 


ERROR 1072: 


Cause: 


ERROR 1073: 


Cause: 


ERROR 1074: 


Cause: 


ERROR 1076: 


Cause: 


ERROR 1077: 


Cause: 


Cannot override ES register 


The destination operand of a string must be compatible 
with the ES register. 


Use the ASSUME directive or segment override operator 
to make sure the operand can be reached with ES. 


Long parameter caused line truncation in 
macro expansion 


Parameter substitution in a macro expansion caused a 
source code line longer than 132 characters to be 
generated. The source line was truncated to 132 
characters. 


IF directives nested too deeply 


IF directives were nested more than 255 levels deep. 


Macros nested too deeply 


Macro expansions were nested more than 65,535 levels 
deep. 


ns 
Missing ENDS for structure definition 


The ENDS required to terminate a structure definition 
block is missing. 


a 
Forced error 


ERROR was forced by .ERR directive. 


nS 
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ERROR 1078: 


Cause: 


ERROR 1079: 


Cause: 


ERROR 1080: 


Cause: 


ERROR 1081: 


Cause: 


ERROR 1082: 


Cause: 


ERROR 1083: 


Cause: 


ERROR 1084: 


Cause: 


ERROR 1085: 


Cause: 
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Forced error - expression equals 0 


ERROR was forced by .ERRE directive. 


Forced error - expression not equal to 0 


ERROR was forced by .ERRNE directive. 


Forced error - symbol defined 


ERROR was forced by .ERRDEF directive. 


Forced error - symbol not defined 


ERROR was forced by .ERRNDEF directive. 


Forced error - string blank 


ERROR was forced by .ERRB directive. 


Forced error - string not blank 


ERROR was forced by .ERRNB directive. 


Forced error - string identical 


ERROR was forced by .ERRIDN directive. 


Forced error - strings different 


ERROR was forced by .ERRDIF directive. 
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ERROR 1086: 


Cause: 


ERROR 


Cause: 


ERROR 


Cause: 


ERROR 


Cause: 


ERROR 


Cause: 


ERROR 


Cause: 


1087: 


1088: 


1089: 


1090: 


1091: 


Cannot change target CPU after a segment 
definition 


Attempt to use .8086, .186, .286, .286c, .286p, .386, .386c, 
.386p, or .PROT after a segment was opened. 


Segment access types must form a compatible set 


Attempt to define a segment with access types which are 
not combinable. For example, ER and RW. 


Module already has a name 


Two NAME directives were encountered in the same 
source program. 


Statement illegal inside structure definition 


A structure definition block is currently open, and the 
statement is not legal within a structure definition. Only 
data declaration statements and comments are legal 
within structure definitions. 


Field cannot be overridden 


An attempt was made to initialize a structure field which 
cannot be initialized when creating a structure instance. 
Any field containing multiple values cannot be 
initialized. 


Override value is too long 


A constant string used to initialize a structure field is too 
long to fit in the field. 
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ERROR 1092: 


Cause: 


ERROR 1093: 


Cause: 


ERROR 1094: 


Cause: 


ERROR 1095: 


Cause: 


ERROR 1096: 


Cause: 


ERROR 1097: 


Cause: 
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Override with DUP is illegal 


An initializer for a structure or record field had a DUP 
operator in the expression. The DUP operator is illegal in 
expressions for initializers. 


More values than defined fields 


There are more values inside the angle brackets for a 
structure or record declaration than there are fields in the 
structure or record. 


Override with string is legal on byte fields only 


An attempt was made to use a constant string as an 
initializer for a field which does not have a data type of 
BYTE. 


Use of structure requires initializer list 


An attempt was made to create an instance of a structure 
without specifying an initializer list. The angle brackets 
(<>) must be present, even if the list is empty. 


Field width specifier must be absolute constant 


The width specifier for a record field being defined is 
required to be an absolute constant. 


Field value must be absolute constant 


The value for a record field must be an absolute constant. 
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ERROR 1098: 


Cause: 


ERROR 


Cause 


ERROR 


Cause: 


ERROR 


Cause: 


ERROR 


Cause: 


ERROR 


Cause: 


1099: 


1100: 


ss 8 


L1OZzs 
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Default field value is too large for field width 


The default value for a field in the record being created is 
too large to fit in the width specified for the field. 


Initial field value is too large for field width 


The initializer for a record field is too large to fit in the 
field that is being initialized. 


Total size of record fields is too large 


The total size of the fields in the record being created is 
larger than 32 bits (or larger than 16 bits and the target 
CPU is not an 80386). 


Use of record requires initializer list 


An attempt was made to create an instance of a record 
without specifying an initializer list. The angle brackets 
(<>) must be present, even if the list is empty. 


String illegal for record field override 


An attempt was made to use a constant string as an 
initializer for a field in a record instance being created. 


Local symbol not allowed with this directive 


A symbol local to a procedure block (a symbol that begins 
with a “#” character) can not be defined with this 
directive. Only the data declaration directives, EQU, 
LABEL, and =, can be used to create local symbols. 
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ERROR 1104: 


Cause: 


ERROR 1105: 


Cause: 


ERROR 1106: 


Cause: 


Solution: 


ERROR 1107: 


Cause: 


ERROR 1108: 


Cause: 
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Local symbol must be defined inside a procedure 


A local symbol (a symbol beginning with a “#” character) 
can only be defined inside a procedure block. 


Align directive requires a power of two 


The operand to the align directive must be a power of 2, or 
the location counter will not be changed. 


Descriptor table register requires PWORD operand 


Instructions which operate on the descriptor table registers 
(IDTR and GDTR) require their memory reference 
operand to have a data type of PWORD. 


The PTR operator can be used to coerce the data type of 
memory reference operand to PWORD if necessary. 


Location counter has wrapped 


The location counter in the currently open segment has 
overflowed and wrapped around. This will cause the 
initialized data at the beginning of the segment to be 
destroyed and make the size of the segment incorrect at 
link time. 


Count for DUP operator cannot be a forward 
reference 


The count parameter used with the DUP operator must be 
a constant value, and cannot include a reference to a 
symbol defined later in the source file. 
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ERROR 1109: 


Cause: 


Relocatable ORG value must lie in current segment 


The value for the ORG directive was relocated relative to 
a different segment than the one currently being 
assembled. 386! ASM requires the operand to ORG to be 
absolute or relocated relative to the currently open 
segment. 


B.3 Fatal Errors 


FATAL ERROR 2001: System error 


Cause: 


A bug in 386! ASM. Save a copy of the source code file(s) 
which caused the error, and call Phar Lap. 


FATAL ERROR 2002: Can't create listing file: filename 

FATAL ERROR 2003: Can't create object file: filename 

FATAL ERROR 2004: Can't create error list file: filename 
FATAL ERROR 2005: Can't create cross-reference file: filename 


Cause: 


Solution: 


1. You have misspelled the name of the file or its 
directory. 

2. The directory in which the file is to be placed does not 
exist, or you do not have write access to the directory. 

3. The disk is full. 


1. Correctly spell the file or directory name. 
2. Clear up the access problem. 
3. Discard unused files to free up space on the disk. 
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FATAL ERROR 2006: Error writing to listing file: filename 
FATAL ERROR 2007: Error writing to object file: filename 
FATAL ERROR 2008: Error writing to error list file: filename 
FATAL ERROR 2009: Error writing to cross-reference file: 


filename 
Cause: The disk is full. 
Solution: Discard unused files to free up space on the disk. 


FATAL ERROR 2010: Can't open source code file: filename 
Cause: 1. You have misspelled the name of the file or its 


directory. 
2. You do not have read access to the file or directory. 


Solution: 1. Correctly spell the file or directory name. 


2. Clear up the access problem. 


FATAL ERROR 2011: Error reading source code file: filename 


Cause: The file is probably damaged. 


Solution: Recreate the file, or restore it from a backup copy. 


FATAL ERROR 2012: Out of memory 


Cause: 386! ASM has run out of space to keep the symbol table in 
memory. 
Solution: Break up the source code file into two or more files to be 


assembled separately and combined with 386] LINK. 
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FATAL ERROR 2013: Symbol changed offset on pass 2 
FATAL ERROR 2014: Procedure changed size on pass 2 
FATAL ERROR 2015: Segment changing size on pass 2 


Cause: A bug in 3861 ASM. Save a copy of the source code file(s) 
that caused the error, and call Phar Lap. 


FATAL ERROR 2016: Illegal symbol name defined on 
command line: symbolname 


Cause: The symbol name defined on the command line with the 


-DEFINE switch does not follow the syntax rules for legal 
symbol name construction. 
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Syntactical Elements 


C.1 Character Set 


386 | ASM recognizes the following character set: 


* 1.2 
space carriage return line feed horizontal tab 


When 386! ASM encounters any character not in this set, it treats it as a 
space. 


OO al 


C.2. Statements 


386 | ASM processes source code files one line at a time, where a line is 
terminated by a line feed character or or by a carriage return/line feed 
character pair. Source code lines may be no longer than 132 characters in 
length. 


386 | ASM parses each source code line to break it up into tokens. Tokens 
fall into one of the following categories: delimiters, assembler reserved 
names, identifiers (user-defined names), constant numeric values, and 
string constants. Delimiters are always a single source character. All other 
tokens may be one or more source characters in length and are terminated 
by any character which does not follow the syntax rules for the token type. 
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A statement must be on a single line of the source file and takes the 
general form: 


{identifier} mnemonic {operand,...} {; comment } 


where items in brackets are optional and mnemonic is an instruction 
mnemonic or a directive name. 


C.3. Assembler Reserved Names 


A reserved name is a name that has a special meaning to 386! ASM. 
Reserved names may not be redefined. Reserved names include 
instructions, directives, register names, and expression operators, all of 
which are listed in separate appendices in this manual. In addition, the 
names listed in Table C-1 are reserved names. All upper and lower case 
combinations of these names are treated as the same name, regardless of 
whether case-sensitive assembly is enabled. 


TABLE C-1 
MISCELLANEOUS RESERVED NAMES 


808360nly = Description 


Data type used with EXTRN directive 
Variable data type 
Variable data type 


Operator used with data declarations to specify 


replication of values 
Segment access type attribute 
Segment access type attribute 
Label data type 

FWORD Variable data type 

NEAR Label data type 
Keyword for ASSUME directive 
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TABLE C-1, CONTINUED 


Name 808360nly § Description 


PARA no Segment align type 


tL 


C.4 Identifiers 


I 


Identifiers are user-defined names. Identifiers may be any combination of 
the following characters: 
A-Z 
a~Z 
0-9 
? $ @ 


The identifier may not begin with a number. Only the first 31 characters 
in an identifier are significant; all others are ignored. Unless case 
sensitivity is enabled with a command line switch, upper and lower case 
versions of the same identifier are considered to be identical by 386! ASM. 


In addition, local identifiers may be defined within a procedure block by 
beginning the identifier name with the pound character (#). Local 
identifiers are recognized only within the procedure block in which they 


are defined. 
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C.5 Delimiters 


Delimiters are one-character tokens with a particular meaning, sometimes 
context sensitive, to 386! ASM. The delimiters recognized by 386! ASM are 
listed in Table C-2. 


TABLE C-2 
DELIMITERS 


<> &!% Macro operators 
Beginning of comment portion of a statement 
Separates operands of an instruction or directive 


Represents current value of location counter within the current 
segment 


Used to enclose string constants 


C.6 Constants 


Integers: 


digits{radix_specifier} 


Integer numbers are a string of one or more digits in the default radix 
(which may be set by use of the .RADIX directive). The A-F digits used to 
enter hexadecimal numbers may be given in upper or lower case. A radix 
specifier (Table C-3) may be appended to the digit string to override the 
default radix. Note that hexadecimal numbers must always start with a 
decimal digit (0-9); tokens that begin with a letter are treated as identifiers. 
If necessary, put a leading 0 on a hexadecimal number to identify it as a 
number. 
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TABLE C-3 
RADIX SPECIFIERS 


Radix Specifi Radi 


binary (base 2) 


B 

Q octal (base 8) 

O octal (base 8) 

D decimal (base 10) 


H hexadecimal (base 16) 


Real Numbers: 


digits. {digits} {E{+|-}digits} 


A real number is composed of a required integer part, a required decimal 
point, an optional fractional part, and an optional exponent. All digits 
must be decimal (0-9). Real numbers may only be used with the DD, DQ, 
and DT directives. Please see the appendix on data types for the range of 
real numbers allowed for each directive. 


Encoded Real Numbers: 

digitsR 
Encoded real numbers are entered as an eight digit (for DD), 16 digit (for 
DQ), or 20 digit (for DT) hexadecimal number followed by the real number 
specifier R. If the number has a leading 0, the number of its digits may be 
increased by one. 
Packed Decimal Numbers: 

digits 
A packed decimal number is a decimal number stored in 8087 packed 


decimal format. A packed decimal number is created by the DT directive 
when the default radix is decimal and no radix specifier is used at the end 


386IASM Reference Manual 199 


Syntactical Elements 


of the number. The maximum number of digits in a packed decimal 
number is 18. 


aca ccaaaaacacaaacaaaaaaaaacacaaacacaaacaaaaaaaaacacaaacaaaaaaaaaaa 


C.7 String Constants 


String constants are a string of one or more printable ASCII characters, 
non-printable ASCII characters other than the NUL (0) character, or non- 
ASCII characters (characters with bit 7 set) enclosed in double quotation 
marks (") or right single quotation marks (’). 


To encode the quotation mark that encloses the string as part of the string, 
the quotation mark character must be typed twice. For example, "a'"b'"c" 
encodes the string a"b'"c. 


Strings of up to eight characters in length may also be used as integer 
values provided they will not overflow the specified data type. The ASCII 
value of each character in the string is stored as one byte in the integer, 
with the rightmost character in the string stored as the least significant 
byte in the integer. 
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TABLE D-1 
80386 INSTRUCTION SET 


Processor 


Instruction Required Syntax 


ASCII adjust AL for addition 


8086 ASCII adjust AL for division 
ASCII adjust AL for 
multiplication 
ASCII adjust AL for 
subtraction 

ADC accum, immed Add immediate with carry to 


accumulator 


ADC r/m, immed Add immediate with carry to 
operand 


ADC r/m, reg Add register with carry to 
operand 


ADC reg, r/m Add operand, carry to register 


ADD accum, immed Add immediate to 
accumulator 


ADD r/m, immed Add immediate to operand 
ADD reg, r/m Add operand to register 
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Instruction 


AND 


ARPL 


BOUND 
BSF 
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Processor 


Required 


8086 


8086 


8086 
8086 
80286 P 


80186 
80386 
80386 
80386 
80386 
80386 


80386 


Syntax 


AND accum, immed 


AND r/m, immed 


AND r/m, reg 
AND reg, r/m 
ARPL mem, reg 


BOUND reg, mem 
BSF reg, r/m 

BSR reg, r/m 

BT r/m, reg 

BT r/m, immed 


BTC r/m, reg 
BTC r/m, immed 
BTR r/m, reg 


BTR r/m, immed 


BTS r/m, reg 


BTS r/m, immed 


TABLE D-1, CONTINUED 


AND immediate with 
accumulator 


AND immediate with 
operand 


AND register with operand 
AND operand with register 


Adjust requested privilege 
level 


Detect value out of range 
Find least significant one bit 
Find most significant one bit 
Test bit indexed by register 
Test bit indexed by immediate 


Test and complement bit 
indexed by register 


Test and complement bit 
indexed by immediate 


Test and clear bit indexed by 
register 


Test and clear bit indexed by 
immediate 


Test and set bit indexed by 
register 


Test and set bit indexed by 
immediate 
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TABLE D-1, CONTINUED 


Processor 


Instruction Required Syntax ription 


CALL 8086 
80 CALL r/m Call instruction indirect 


86 
LD CLD i i 
I 80 CLI 
CLTS 


CALL label Call instruction at label 


C 8086 Clear direction flag 
CL 86 Clear interrupt flag 


CLTS 80286 P Clear task-switched flag 


CMC 8086 CMC Complement carry flag 
CMP 8086 


CMP accum, immed | Compare immediate with 
accumulator 


8086 CMP r/m, immed Compare immediate with 
operand 

8086 CMP r/m, reg Compare register with 
operand 

8086 CMP reg, r/m Compare operand with 


register 
CMPS 8086 CMPS src, dest Compare strings 

CMPSB 8086 CMPSB Compare BYTE strings 
CMPSD 8086 CMPSD Compare DWORD strings 
CMPSW 8086 CMPSW Compare WORD strings 


CWD 8086 CWD Sign extend AX to DX:AX 
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Processor 


Instruction Required Syntax 


CWDE 80386 CWDE Sign extend EAX to EDX:EAX 


DAA 8086 DAA Decimal adjust AL for 
addition 
AS 8086 DAS Decimal adjust AL for 
subtraction 
Cc 8086 


D 
DE 


DEC r/m Decrement operand 
8086 DEC reg Decrement full-size register 


DIV 8086 DIV r/m Divide accumulator by 
operand 


ENTER 80186 ENTER imml16, Enter procedure 
1mm8 


ESC 8086 ESC immed, r/m Escape with 6 bit immed and 
operand 


HILT 80 HLT Halt 


86 
IDIV 8086 IDIV r/m Integer divide accumulator by 
operand 


8086 IMUL r/m Integer multiply accum by 
operand 


80186 IMUL reg, immed Integer multiply register by 
immediate 


80186 IMUL reg, r/m, Operand by immed, result in 
immed register 


80386 IMUL reg, r/m Multiply register by operand 


(cont.) 
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Processor 


Instruction Required Syntax 


IN 8086 IN accum, immed Input from port (8 bit 
immediate) 


8086 IN accum, DX Input from port given by DX 


INC 8086 INC r/m Increment operand 
8086 INC reg Increment 16 bit register 
INS 80186 INS mem, DX Input string from port DX 


INSB 80186 INSB Input BYTE string from port 
DX 


INSD 80386 INSD Input DWORD from port DX 
to dest string 


INSW 80186 INSW Input WORD string from port 
DX 


INT 3 8086 INT 3 Software interrupt 3 
(breakpoint interrupt) 

INT 8086 INT immed Software interrupt 0-255 

INTO 8086 INTO Interrupt on overflow 


IRET 8086 IRET Return from interrupt 


IRETD 80386 IRETD Protected mode return from 
interrupt 


(cont.) 
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Processor 


Instruction Required Syntax 


JCXZ 8086 JCXZ label Jump if CX register is zero 
JE 


8086 JE label Jump if equal 


JECXZ 80386 JECXZ label Jump if ECX register is zero 


|G 8086 JG label Jump if greater 
JGE 8086 JGE label Jump if greater or equal 
JL 8086 JL label Jump if less than 


JMP 8086 JMP label Jump to instruction at label 
8086 JMP r/m Jump to instruction indirect 
JNA label Jump if not above 
JNAE 8086 JNAE label Jump if not above or equal 
JNBE 8086 JNBE label Jump if not below or equal 
JNE 8086 JNE label Jump if not equal 


JN 8086 JNG label Jump if not greater 


G 
ae: << 
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Processor 


Instruction Required Syntax ription 
JN 6 JNS label Jump if sign flag is set 


S 808 
JNZ 8086 JNZ label Jump if not zero 
JO 8086 JO label Jump if overflow flag is set 


8086 JP label Jump if parity flag is set 


JP 
JPE JPE r/m Jump if parity even 
S 


8086 
8086 i 
8086 


JZ JZ label Jump if zero flag is set 


LAHF LAHF Load AH with flags 

LAR 80286 P LAR reg, mem Load access rights 

LDS 8086 LDS reg, r/m Load FAR pointer into DS: 
register 

LEA 8086 LEA r/m Load effective address of 
operand 

LEAVE 80186 LEAVE Leave procedure 

LES 8086 LES reg, r/m Load FAR pointer into ES: 
register 

LFS 80386 LFS reg, r/m Load FAR pointer into FS: 
register 

LGDT 80286 P LGDT mem Load GDT register from 
memory (24 bit base) 

LGDTE 80386 P LGDTE mem Load GDT register from 
memory (32 bit base) 


386IASM Reference Manual 207 


80386 Instruction Set 


Processor 


Instruction Required Syntax 


LODSD 


LODSW 


LOOPE 


LOOPNE 


LOOPNZ 


LOOPZ 


80386 


80286 P- 


80386 P 


80286 P 


80286 P 


80386 


8086 


8086 


8086 


8086 


LGS reg, r/m 
LIDT mem 
LIDTE mem 
LLDT mem 


LMSW mem 


LODS src 
LODSB 
LODSD 


LODSW 


LOOP label 
LOOPE label 


LOOPNE label 


LOOPNZ label 


LOOPZ label 


TABLE D-1, CONTINUED 


—e 


Load far pointer into GS: 
register 


Load IDT register from 
memory (24 bit base) 


Load IDT register from 
memory (32 bit base) 


Load local-descriptor table 
register 


Load machine-status word 


Load string element 
Load BYTE from string into AL 


Load DWORD from source 
string into EAX 


— WORD from string into 


Loop to instruction at label 


Loop while equal to 
instruction at label 


Loop while not equal to 
instruction at label 


Loop while not zero to 
instruction at label 


Loop while zero to instruction 
at label 
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Processor 


80286 P 


LSL reg, mem Load segment limit 


LSS 80386 LSS reg, r/m Load FAR pointer into SS: 
register 
LTR 80286 P LTR mem Load task register 


MOV 8086 MOV accum, mem Move memory to accumulator 
8086 MOV mem, accum Move accumulator to memory 
8086 MOV r/m, immed Move immediate to operand 
8086 MOV r/m, reg Move register to operand 
8086 MOV 1r/m, segreg Move segment register to 

operand 
8086 MOV reg, immed Move immediate to register 
8086 MOV reg, r/m Move operand to register 
8086 MOV segreg, r/m Move operand to segment 
register 
80386 P MOV reg, Creg Move control register to 
general register 


80386 P MOV reg, Dreg Move debug register to general 
register 


80386 P MOV reg, Treg Move test register to general 
register 

80386 P MOV Creg, reg Move register to control 
register 

80386 P MOV Dreg, reg Move register to debug register 


Move register to test register 


80386 P MOV Treg, reg 
MOVS 8086 MOVS dest, src Move string 
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Processor 


MOVSB 8086 MOVSB Move BYTE string 


MOVSD 80386 MOVSD Move DWORD string 


MOVSW 8086 MOVSW Move WORD string 
MOVSX 80386 MOVSX reg, r/m 


Move byte/word operand to 
word/dword register with 
zero extend 


MOVZX 80386 MOVZX reg,r/m Move byte/word operand to 
word/dword register with sign 


extend 


MUL 8086 MUL r/m Multiply accumulator by 
operand 


NOT 8086 ‘ 
R 8086 


NOT r/m (1’s complement) operand 


O OR accum, immed OR immediate with 


accumulator 
8086 OR r/m, immed OR immediate with operand 
8086 OR r/m, reg OR register with operand 


OR reg, r/m 
OUT 8086 OUT DX, accum Output to port given by DX 


8086 OUT immed, accum Output to port (8 bit 
immediate) 


OUTS 80186 OUTS DX, mem Output string to port DX 


OR operand with register 
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Processor 


Instruction Required Syntax 


ee 


OUTSB 80186 OUTSB DX, mem Output BYTE from source 
string to port DX 
80386 OUTSD Output DWORD from source 
string to port DX 


OUTSW 80186 OUTSW DX, mem Output WORD from source 
string to port DX 


8086 POP r/m Pop operand from stack 
8086 POP reg Pop register from stack 
8086 POP segreg Pop segment register from 


stack 


POPA 80186 POPA Pop all 16 bit general registers 
from stack 


POPAD 80386 POPAD Pop all 32 bit general registers 
from stack 


POPF 8086 POPF Pop flags from stack 
POPFD 80386 POPFD Pop 32 bit EFLAGS register 


8086 PUSH r/m Push 16 bit operand on the 
stack 


8086 PUSH reg Push 16 bit register on the 
stack 

8086 PUSH segreg Push segreg on the stack 

80186 PUSH immed Push immediate data on the 


stack 


PUSHA 80186 PUSHA Push all 16 bit general 
registers on the stack 
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Processor 


Instruction Required Syntax 


PUSHAD 


PUSHF 
PUSHFD 
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80386 


8086 
80386 
8086 


8086 


80186 


8086 


8086 


80186 


8086 
8086 
8086 
8086 
8086 
8086 


PUSHAD 


PUSHF 
PUSHFD 
RCL r/m, 1 


RCL r/m CL 


RCL r/m, immed 


RCR r/m, 1 


RCR r/m. CL 


RCR r/m, immed 


REP 

REPE 
REPNE 
REPNZ 
REPZ 

RET [immed] 


TABLE D-1, CONTINUED 


Vicsesinti 


Push all 32 bit general 
registers 


Push flags on the stack 
Push 32 bit EFLAGS register 


Rotate left through carry by 
one bit 


Rotate left through carry by 
count in CL 


Rotate left through carry by 
immediate 


Rotate right through carry by 
one bit 


Rotate right through carry by 
count in CL 


Rotate right through carry by 
immediate 


Repeat instruction 


Repeat instruction if equal 


Repeat instruction if not equal 


Repeat instruction if not zero 
Repeat instruction if zero 


Return, popping optional bytes 
from stack 
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Processor 


Instruction Required 


ROL 8086 
8086 
80186 


8086 


8086 
80186 


8086 


Syntax 


ROL r/m, 1 

ROL r/m, CL 
ROL r/m, immed 
ROR r/m, 1 

ROR r/m, CL 
ROR r/m, immed 


SAL r/m, 1 


SAL r/m, CL 
SAL r/m, immed 


SAR r/m, 1 


SAR r/m, CL 
SAR r/m, immed 


SBB accum, immed 


SBB r/m, immed 


SBB r/m, reg 
SBB reg, r/m 
SCAS dest 
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—— 


Rotate left by one bit 
Rotate left by CL 

Rotate left by immediate 
Rotate right by one bit 
Rotate right by CL 

Rotate right by immediate 
Store AH into flags 

Shift arithmetic left by one 
bit 

Shift arithmetic left by CL 


Shift arithmetic left by 
immediate 


Shift arithmetic right by one 
bit 
Shift arithmetic right by CL 


Shift arithmetic right by 
immediate 


Subtract immediate with 
borrow 


Subtract immediate with 
borrow 


Subtract register with borrow 


Subtract operand with borrow 


Scan string 
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Processor 


SCASB 8086 SCASB Scan string for BYTE in AL 


SCASD 80386 SCASD Scan string for DWORD in 
EAX 


SCASW 8086 SCASW Scan string for WORD in AX 
SETA 80386 SETA r/m Set byte if above 

SETAE 80386 SETAE r/m Set byte if above or equal 
SETB 80386 SETB r/m Set byte if below 

SETBE 80386 SETBE r/m Set byte if below or equal 
SETC 80386 SETC r/m Set byte on carry 

SETE 80386 SETE r/m Set byte if equal 

SETG 80386 SETG r/m Set byte if greater 

SETGE 80386 SETGE r/m Set byte if greater than or 


equal 
SETL 80386 SETL r/m Set byte if less than 
SETLE 80386 SETLE r/m Set byte if less than or equal 
SETNA 80386 SETNA r/m Set byte if not above 
SETNAE 80386 SETNAE r/m Set byte if not above or equal 
SETNB 80386 SETNB r/m Set byte if not below 
SETNBE 80386 SETNBE r/m Set byte if not below or equal 
SETNC 80386 SETNC r/m Set byte on not carry 
SETNE 80386 SETNE r/m Set byte if not equal 
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Processor 


Instruction Required Syntax 


Descripti 


80386 


SETNG r/m Set byte if not greater than 


SETNGE 80386 SETNGE r/m Set byte if not greater than or 
equal 

SETNLE 80386 SETNLE r/m Set byte if not less than or 
equal 

SETNO 80386 SETNO r/m Set byte on not overflow 

SETNP 80386 SETNP r/m Set byte if parity flag = zero 

SETNS 80386 SETNS r/m Set byte on not sign 

SETNZ 80386 SETNZ r/m Set byte if not zero 

SETO 80386 SETO r/m Set byte on overflow 

SETP 80386 SETP r/m Set byte on parity flag 

SETPE 80386 SETPE r/m Set byte if parity even 

SETPO 80386 SETPO r/m Set byte if parity odd 

SETZ 80386 SETZ r/m Set byte if zero 

SGDT 80286 P SGDT mem Store GDT register in memory 


(24 bit base) 


SGDTE 80386 P SGDTE mem Store GDT register in memory 
(32 bit base) 
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Processor 


Instruction Required 


80286 P 


80386 P 


80286 P 


80286 P 
8086 


Syntax 


SHL r/m, 1 

SHL r/m, CL 
SHL r/m, immed 
SHLD r/m, reg, cl 
SHLD r/m, reg, 
immed 

SHR r/m, 1 

SHR r/m, CL 
SHR r/m, immed 
SHRD r/m, reg, cl 
SHRD r/m, reg, 
immed 


SIDT mem 


SIDTE mem 


SLDT mem 


SMSW mem 
STC 


TABLE D-1, CONTINUED 


Descripti 


Shift left by one bit 
Shift left by CL 
Shift left by immediate 


Shift CL bits from reg left into 
r/m 


Shift immediate bit count 
from reg left into r/m 


Shift right by one bit 
Shift right by CL 


Shift right by immediate 


Shift CL bits from reg right 
into r/m 


Shift immediate bit count 
right from reg into r/m 


Store IDT register in memory 
(24 bit base) 


Store IDT register in memory 
(32 bit base) 


Store local-descriptor table 
register 


Store machine-status word 
Set carry flag 


Set direction flag 
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Processor 


STI 8086 STI Set interrupt flag 
STOD dest Store string 


STOSB 8086 STOSB Store BYTE from AL at 
destination string 


STOSD 80386 STOSD Store DWORD from EAX at 
destination string 


STOSW 8086 STOSW Store WORD from AX at 
destination string 


SUB accum, immed Subtract immediate from 
accumulator 


SUB r/m, immed Subtract immediate from 
operand 


SUB r/m, reg Subtract register from operand 
SUB reg, r/m Subtract operand from register 


TEST accum, immed Test immediate bits in 
accumulator 


TEST r/m, immed Test immediate bits in 
operand 


TEST r/m, reg Test register bits in operand 


8086 TEST reg, r/m Test operand bits in register 


VERR 80286 P VERR mem Verify read access 


80286 P VERW mem Verify write access 
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Processor 


Instruction Required Syntax 


Wesations 


XCHG 8086 XCHG accum, reg Exchange accumulator with 


register 

8086 XCHG r/m, reg Exchange operand with 
register 

8086 XCHG r/m, accum Exchange register with 
accumulator 


8086 XCHG reg, r/m Exchange register with 
operand 


Translate 


XOR accum, immed XOR immediate with 
accumulator 


XOR r/m, immed XOR immediate with operand 
8086 XOR r/m, reg XOR register with operand 
XOR reg, r/m 


XOR operand with register 
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80287 INSTRUCTION SET 


Processor 


Instruction Required Syntax Description 


F2XM1 8087 F2XM1 Calculate 2* - 1 

FADD 8087 FADD Add ST(1) to ST and pop 
8087 FADD mem Add real in memory to ST 
8087 FADD ST, ST(i) Add ST(i) to ST 


FADD ST(i), ST |= Add ST to ST(i) and pop 
FADDP 8087 FADDP ST(i), ST |Add ST to ST(i) and pop stack 


FBLD 8087 FBLD mem Load 10-byte BCD value on stack 
FBSTP 8087 FBSTP mem Store 10-byte BCD value and pop 
FCHS 8087 FCHS Change sign of the top of the stack 


FCLEX 

FCOM 8087 FCOM Compare ST with ST(1) 

8087 FCOM ST Compare ST with real in memory 

8087 FCOM ST(i) Compare ST with ST(i) 

FCOMP 8087 FCOMP Compare ST with ST(i) and pop stack 
8087 FCOMP ST Compare ST with memory and pop 


8087 FCOMP STC(i) Compare real with stack and pop 
stack 


8087 FCLEX Clear exceptions after WAIT 


FCOMPP 8087 FCOMPP Compare ST with ST(i) and pop stack 
twice 


FDECSTP 8087 FDECSTP Decrement floating point stack 
pointer 
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FDISI 8087 only _FDISI Disable interrupts after WAIT 
(generates no code for 287 target) 


8087 FDIV Divide ST(1) by ST and pop 
8087 FDIV mem Divide ST by real in memory 
8087 FDIV ST, ST(i) Divide ST by ST(i) 
8087 FDIV ST(i), ST Divide ST(i) by ST 
FDIVP 8087 FDIVP ST(i), ST = Divide ST(i) by ST and pop stack 


FDIVR 8087 FDIVR Divide ST by ST(i), leave result in 
ST(i) and pop 


8087 FDIVR mem Divide memory by ST, leave result in 
ST 


8087 FDIVR ST, ST(i) Divide ST(i) by ST, leave result in ST 


8087 FDIVR ST(i), ST Divide ST by ST(i), leave result in 
ST(i) 


FDIVRP 8087 FDIVRP ST(i), ST Divide ST by ST(i), leave result in 
ST(i) and pop 


FENI 8087 only FENI Enable interrupts after WAIT 
(generates no code for 287 target) 


FFREE 8087 FFREE Mark ST as free 
8087 FFREE ST Mark ST as free 
8087 FFREE ST(i) Mark ST(i) as free 
FIADD 8087 FIADD mem 


FICOM 8087 FICOM mem Compare ST with two or four byte 
integer 


Add two or four-byte integer to ST 
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Processor 
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FICOMP 8087 FICOMP mem Compare ST with two or four byte 
integer and pop 

FIDIV 8087 FIDIV mem Divide ST by two or four byte integer 

FIDIVR 8087 FIDIVR mem Divide two or four byte integer by ST, 


leave result in ST 


FILD 8087 FILD mem Push a two, four, or eight byte integer 
on the floating point stack 


FIMUL 8087 FIMUL mem Two or four byte integer multiply 
FINCSTP 8087 FINCSTP Increment floating point stack pointer 
FINIT 8087 FINIT Initialize processor after WAIT 
FIST 8087 FIST mem Store ST as a two or four byte integer 


at mem 


FISTP 8087 FISTP mem Store ST as a two, four, or eight byte 
integer and pop 


FISUB 8087 FISUB mem Subtract a two or four byte integer 
from ST 


FISUBR 8087 FISUBR mem Subtract ST from two or four byte 
integer, leave result in ST 


FLD 8087 FLD mem Push a four, eight, or ten byte real on 
the floating point stack 


FLDCW 8087 FLDCW mem Load coprocessor control word 


FLDENV 8087 FLDENV mem Load coprocessor environment (14 
bytes) 

FLD1 8087 FLD1 Push 1.0 

FLDL2E 8087 FLDL2E Push log>e on the floating point stack 
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FLDL2T 
FLDLG2 
FLDLN2 
FLDPI 
FLDZ 


FMULP 
FNCLEX 
FNDISI 


FNENI 


FNINIT 
FNOP 
FNSAVE 


FNSTCW 


FNSTENV 
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8087 
8087 
8087 
8087 
8087 


8087 
8087 
8087 only 


8087 only 


8087 
8087 
8087 


8087 


8087 


FLDL2T 
FLDLG2 
FLDLN2 
FLDPI 

FLDZ 

FMUL 

FMUL mem 
FMUL ST, ST(i) 
FMUL ST(i), ST 
FMULP ST(i), ST 
FNCLEX 
FNDISI 


FNENI 


FNINIT 
FNOP 
FNSAVE mem 


FNSTCW mem 


FNSTENV mem 


Push log 210 on the floating point stack 
Push log92 on the floating point stack 
Push log,2 on the floating point stack 
Push x on top of stack 

Load +0.0 on the floating point stack 
Multiply ST(1) by ST and pop 
Multiply ST by real in memory 
Multiply ST by ST(i) 

Multiply ST(i) by ST 

Multiply STG) by ST and pop 

Clear exceptions with no WAIT 


Disable interrupts with no WAIT 
(generates no code for 287 target) 


Enable interrupts with no WAIT 
(generates no code for 287 target) 


Initialize processor with no WAIT 
No operation 


Save coprocessor state (94 bytes), no 
WAIT 


Store coprocessor control word with no 
WAIT 


Store coprocessor environment (14 
bytes) with no WAIT 
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FNSTSW 8087 FNSTSW mem Store coprocessor status word with no 
WAIT 


Store 80287 status word in AX with no 
WAIT 


80287 


FNSTSW AX 


FPATAN 8087 FPATAN Compute arctan (ST(1)/ST), leave 
result in ST after popping once 

FPREM 8087 FPREM Compute partial modulus of ST mod 
ST(1) 


FSORT 8087 FSORT Calculate square root of ST, leave 
result in ST 


Store ST in ST(i) 


Store ST as 4- or 8-byte real at mem 


FST ST(i) 
FST mem 


FSTCW 8087 FSTCW mem Store coprocessor control word with 
WAIT 


FSTENV 8087 FSTENV mem Store coprocessor environment after 
WAIT 


FSTP 8087 FSTP mem Store ST as a four, eight, or ten byte 
real and pop 
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FSTSW 8087 FSTSW mem Store coprocessor status word after 
WAIT 


80287 FSTSW AX Store 80287 status word in AX after 
WAIT 


FSUB 8087 FSUB Subtract ST from ST(1) and pop 
8087 FSUB mem Subtract real in memory from ST 
8087 FSUB ST, ST(i) Subtract ST(i) from ST 
8087 FSUB ST(i), ST Subtract ST from ST(i) 


FSUBP 8087 FSUBP ST(i), ST Subtract ST from ST(i) and pop 


FSUBR 8087 FSUBR Subtract ST(1) from ST, leave result in 
ST(1) and pop 


8087 FSUBR mem Subtract ST from real in memory, 
leave result in ST 


8087 FSUBR ST, ST(i) | Subtract ST from ST(i), leave result in 
ST 


8087 FSUBR ST(i), ST Subtract ST(i) from ST, leave result in 
ST(i) 


FSUBRP 8087 FSUBRP ST(i), ST Subtract ST(i) from ST, leave result in 
ST(i) and pop 


FTST 8087 FTST Compare ST with 0.0 


FWAIT 8087 FWAIT Wait for last coprocessor operation to 
complete 


8087 Examine ST, set coprocessor condition 
codes 
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FXCH 8087 FXCH Exchange ST and ST(1) 
8087 FXCH STC(i) Exchange ST and ST(i) 


FXTRACT — 8087 FXTRACT Decompose ST into exponent and 
significand 


FYL2X 8087 FYL2A Compute Y log>x 
FYL2P1 8087 FYL2P1 Compute Y log>(x+1) 
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Assembler Directives 


TABLE E-1 
ASSEMBLER DIRECTIVES 


Directive Statement Syntax 
Name 


186 186 Enables assembly of 80186 
instructions. 


Enables assembly of 80286 
nonprotected instructions. 


= .286p Enables assembly of all 80286 
instructions. 


Enables assembly of 80287 
instructions. 


Enables assembly of 80386 
nonprotected instructions. This is 
the default mode. 


.386p .386p Enables assembly of all 80386 
instructions. 


Enables assembly of 80387 
instructions. 


Enables assembly of 8086 
instructions. 


Lay 
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Statement Syntax 


8087 8087 Enables assembly of 8087 
instructions. 


Creates the symbol name with 
the value of expression. The 
symbol will be a constant, 

variable, or label. 


name = expression 


ASSUME 


ASSUME registername:segname Indicates to the assembler that 
registername will point at the 
segment or group named segname 
during the execution of the 
program. If segname is 
NOTHING, the register is 
assumed to have an undefined 

value. 


COMMENT 


COMMENT delim text delim Causes the assembler to treat all 
text between the two occurrences of 
delim asa comment. Text may 
include carriage returns, so multi- 
line comments are possible. 


{name} DB value... Allocates and initializes one byte 
of memory for each value. If the 
optional name is present, a 
variable of type BYTE is created 


with the specified name. 


{name} DW value.... Allocates and initializes one 
word (two bytes) of memory for 
each value. If the optional name 
is present, a variable of type 
WORD is created with the 


specified name. 
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{name} DD value.... 


{name} DP value... 


{name} DF value.... 


{name} DQ value... 


{name} DT value... 


END {entry} 
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Allocates and initializes a double 
word (four bytes) of memory for 
each value. If the optional name 
is present, a variable of type 
DWORD is created with the 
specified name. 


Allocates and initializes three 
words (six bytes) of memory for 
each value. If the optional name 
is present, a variable of type 
PWORD is created with the 
specified name. 


Allocates and initializes a quad— 
word (eight bytes) of memory for 
each value. If the optional name 
is present, a variable of type 
QWORD is created with the 
specified name. 


Allocates and initializes ten 
bytes of memory for each value. If 
the optional name is present, a 
variable of type TBYTE is created 
with the specified name. 


Indicates the end of the true 
portion and the start of the false 
portion of a conditional block. 


Indicates the end of the program 
module being assembled and 
optionally establishes the 
program’s entry point as entry. 
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TABLE E-1, CONTINUED 


Directive Statement Syntax Description 
Name 


ENDIF ENDIF Signals the end of a conditional 
block. 


ENDM Signals the end of a macro or 
repeat block. 


name ENDP Signals the end of the procedure 
definition for name. 


name ENDS Closes the segment named name 
or ends a structure definition for 
name. 


name EQU expression Assigns the value of expression to 
name. Expression can be an 
address expression, an assembler 
keyword, an arbitrary string of 
text, or a constant value. 


Forces the generation of an 
assembler error. 


-ERRB <string> Forces the generation of an 
assembler error if string is blank. 


-ERRDEF -ERRDEF <name> Forces generation of an assembler 
error if there is a symbol named 
name in the assembler’s symbol 
table, and it was defined before 
the current source line. 


-ERRDIF -ERRDIF <str1>, <str2> Forces generation of an assembler 
error if strings str1 and str2 are 
different. 
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-ERRE expression Forces generation of an assembler 
error if given expression is false 
(evaluates to zero). 


-ERRIDN -ERRIDN <str1>, <str2> Forces generation of an assembler 
error if strings str1 and str2 are 
identical. 


-ERRNB <string> Forces the generation of an 


assembler error if string is not 
blank. 


-ERRNDEF -ERRNDEF <name> Forces generation of an assembler 
error if there is not a symbol 
named name in the assembler’s 
symbol table, or if name was 
defined after the current source 
line. 


-ERRNZ expression Forces generation of an assembler 
error if the given expression is true 
(evaluates to a non-zero value). 


Aligns the location counter for the 
currently open segment to an even 
value by generating a NOP 
instruction (90H), if necessary. 


Forces the current macro 
expansion or repeat block to 
terminate immediately. 
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TABLE E-1, CONTINUED 
Statement Syntax 


EXTRN EXTRN name:type,... Signals to the assembler that the 
symbol named name is external to 
the current module and is of type 


type. 
Creates a definition for a group 
name with members from the list 


of one or more segments following 
the directive. 


name GROUP segname.... 


Assembles instructions in the true 
portion of a conditional block if 
expression is true (evaluates to a 
non-zero value). 


IF expression 


Assembles instructions in the true 
portion of a conditional block if 
string is blank. 


IFB <string> 


IFDEF IFDEF name Assembles instructions in the true 
portion of a conditional block if 
there is a symbol named name in 
the assembler’s symbol table, and 
it was defined before the current 


source line. 


IFDIF <str1>, <str2> Assembles instructions in the true 
portion of a conditional block if 


str1 and str2 are different. 


IFE expression Assembles instructions in the true 
portion of a conditional block if 


expression is false (evaluates to 0). 
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TABLE E-1, CONTINUED 
Statement Syntax 


IFIDN <str1>, <str2> Assembles instructions in the true 
portion of a conditional block if 
str1 and str2 are identical. 


IFNB string Assembles instructions in the true 
portion of a conditional block if 
string is not blank. 


IFNDEF IFNDEF name Assembles instructions in the true 
portion of a conditional block if 
there is no symbol named name in 
the assembler’s symbol table, or if 
name was defined after the 
current source line. 


INCLUDE INCLUDE filename Inserts the text contained in the 
source file specified by filename 
into the file currently being 
assembled. 


IRP fparam, <aparam,...> Start of repeat block that will be 
repeated once for each actual 
parameter aparam, with the 
actual parameter value being 
substituted for the formal 
parameter fparam in the text of 
the repeat block. 
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IRPC fparam, string 


name LABEL type 


.LFCOND 


Start of repeat block that will be 
repeated once for each character 
in string, with the current 
character being substituted for 
the formal parameter fparam in 
the text of the repeat block. 


Creates a new variable or 
instruction label of type type with 
a value equal to the location 
counter for the current segment. 


Causes all statements in macro 
expansions to be listed in the 
assembler listing file. 


Causes text in false conditional 
blocks to be copied into the 
assembler listing file even though 
it is not being assembled. 


Enables listing of program 
statements in the assembler 
listing file. 


Enables listing of source lines from 
files included with the 
INCLUDE directive. 
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TABLE E-1, CONTINUED 
Statement Syntax 


LOCAL LOCAL dname.... Creates one or more dummy names 
for use within a macro. The 
dummy name is replaced by an 
assembler-generated unique name 
of the form ??XXXX, where X is a 
hexadecimal digit when the 

macro is expanded. 


name MACRO fparam.... Start of a macro definition block 
for macro name, with formal 


parameter names fparam. 


NAME NAME modulename Sets the name of the module being 
assembled to the first 132 
characters of modulename. 


ORG expression Sets the value of the location 
counter for the currently open 
segment to expression. 


OUT %OUT text Writes text to the user’s terminal 
on both pass one and pass two of 
the assembly. 


%OUT1 %OUT] text Writes text to the user’s terminal 
on pass one of the assembly. 


%OUT2 %OUT2 text Writes text to the user’s terminal 
on pass two of the assembly. 
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Directive Statement Syntax Description 
Name 


PAGE PAGE {length}, {width} Sets the page length and width 
for the listing file to length and 
width, respectively. 


Increments the section number 
used on the header line of listing 
file pages and generates a page 
break. 


Generates a page break in the 
assembler listing file. 


name PROC type Initiates definition of a procedure 
called name of type type. 


-PROT Enables assembly of protected 
instructions for the 80386 or 80286. 


PUBLIC PUBLIC name... Makes the list of variables, 
instruction labels, or absolute 
symbols available to all other 
modules in the program. 


PURGE macroname Has no effect. 


-RADIX -RADIX expression Sets the default radix for numbers 
in the input file to expression. 
Numbers in expression are always 
evaluated in base 10, regardless 
of the current default radix. 


RECORD name RECORD fname:width Defines a record called name 
{=expr},... with bit fields named fname. The 
field width, in bits, is given by 
the constant value width and the 
=expr, if present, defines the 
default value for the field. 
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Directive Statement Syntax 


REPT expression 


Beginning of a block to be repeated 
expression number of times. 


Suppresses the listing of macro 
expansions in the assembler listing 
file. 


SEGMENT — name SEGMENT {align} {combine} Opens a program segment called 


{useatr} {access} {class} 


SSFCOND SSFCOND 


STRUC name STRUC 


SUBTTL SUBTTL {text} 


-TFCOND -TFCOND 


TITLE TITLE text 


.XLIST 


-XLISTI .XLISTI 
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name with attributes align, 
combine, useatr, access, and class. 


Suppresses the listing of subsequent 
false conditional blocks in the 
assembler listing file. 


Signals the beginning of a structure 
definition. 


Sets the subtitle to be used on page 
headers in the listing file to text. 


Toggles the current state of the “list 
false conditional blocks” flag. 


Sets the title to be used on page 
headers in the listing file to text. 


Causes only statements in macro 
expansions which generate object 
code to be listed in the assembler 
listing file. 


Suppresses listing of subsequent 
source lines in the assembler listing 
file. 


Disables listing of source lines from 
files included with the INCLUDE 
directive. 
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80386 Register Names 


TABLE F-1 
80386 REGISTERS 


Register 80386 
Name Only Description 


32 bit general register 


EAX yes 
ESP yes 32 bit stack pointer 


AX no 16 bit general register; low word of EAX 
Pe ee tae re 
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Name Only Description 
AH no high byte of AX 

BH no high byte of BX 

BL no low byte of BX 

CH no high byte of CX 

CL no low byte of CX 

DH no high byte of DX 


low byte of DL 


3 


code segment selector register 


cs no 
yes i 
yes i 
no 


ES 
FS extra data segment selector register 
GS extra data segment selector register 

S 


S stack segment selector register 


Cc machine control register (includes 80286 machine status word) 


RO yes 
R2 yes page fault linear address register 
R3 yes 


Cc 
i page directory base register 
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Register 80386 
Name Only Description 


linear breakpoint address 0 register 


linear breakpoint address 1 register 
linear breakpoint address 2 register 


linear breakpoint address 3 register 
breakpoint status register 


breakpoint control register 


test control register 


test status register 


ST(0)-ST(7) ro —.._~_ 8087 floating point stack registers 


386IASM Reference Manual 241 


80386 Register Names 


242 386IASM Reference Manual 


Appendix G 


Data Types and Ranges 


386 | ASM supports the full range of 80386 and 80287 data types. Table G-1 
lists the available data types and their value ranges. 


All internal arithmetic done by 386! ASM on integer values uses a 33 bit 
sign plus magnitude representation for integer values. This extends the 
possible value range for intermediate results during expression 
evaluation. The final result of expression evaluation is coerced to the 
appropriate data type, and an integer overflow error is reported if the 
result exceeds the allowable value range. 
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TABLE G-1 
DATA TYPES AND RANGES 
Type only tive Bits Description Range (approximate) 
BYTE no DB 8 80386 byte -128 to 127 (signed integer) 
0 to 255 (unsigned integer) 
80386 word -32,768 to 32,767 (signed integer) 
80287 word 0 to 65,535 (unsigned integer) 
integer 
80386 double —_-23! to 291-1 (signed integer) 
word 
80287 short 0 to 292-1 (unsigned integer) 
integer 
80287 short -3.4x 10° to -1.2 x 108 | poa) 
real 1.2 x 10°8 to 3.4x 10°8 


80386 pointer -24” to 247-1 (signed integer) 
word 


or a 16 bit 0 to 248-1 (unsigned integer) 
segment 

selector plus a 

32 bit 

unsigned 

offset 


80287 long -26 to 263.1 (signed integer) 
integer 


80287 long real 0 to 2°4-1 (unsigned integer) 


-1.7x 108 to -2.3x 10°38 } real 
2.3x 10-8 to 1.7x 10908 


80287 packed _-1018-1 to 1018-1 (packed decimal) 
decimal 
80287 1.1 x 104% to -3.4x 10-492 


temporary 3.4x 107492 to 1.1 x 104932 
real 


real 


244 386IASM Reference Manual 


Appendix H 


Expressions and Operators 


An expression is a combination of constant and/or relocatable values 
(operands) and expression operators which evaluate to a single constant 
or relocatable value. Table H-1 lists the expression operators recognized by 
386 | ASM. 


Forward references to identifiers are permitted to occur in expressions 
provided the assumptions made by the assembler on pass one do not 
cause it to generate fewer bytes of object code on pass one than required. 
Common reasons for illegal forward references are forward references that 
would require a segment override byte to be generated, or to a label of type 
FAR. Illegal forward references can usually be corrected by judicious use 
of the PTR and segment override (:) operators. The fewer forward 
references there are in a source code file, the faster 386! ASM assembles it. 


The order of evaluation of expressions depends on operator precedence. 
Operators with highest precedence are evaluated first. Operators of equal 
precedence are evaluated from left to right. Table H-2 shows the operator 
precedence for the 386! ASM expression evaluator. Operators on the same 
line in the table have equal precedence. 
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TABLE H-1 
EXPRESSION OPERATOR SUMMARY 


Relocatable 
Values 


Operator Permitted Syntax Description 


() yes (expr) Forces evaluation of the expression 
within parentheses before any 
adjacent operations. 


Used to generate based and/or 
indexed addressing modes. Also used 
as an index operator to add the 

values of two expressions. 


expr [basereg] 
expr [indexreg] 
expr [expr2] 
expr:strfldname 


expr1:expr2 


The structure field name operator 
adds the offset of a field within a 
structure to the expression and sets 
the data type of the expression to 
the data type of the field. It is also 
used interchangebly with the + 
operator in order to add two 
expressions. 


segreg:expr 
segname:expr 


The segment override operator forces 
the address of expr to be computed 
relative to the specified segment 
groupname-expr register, segment, or group. It also 
causes 3861 ASM to generate a 
segment override byte before the 
instruction, if necessary. A named 
segment or group must be assigned to 
a segment register with the 
ASSUME directive before it can be 
used with the segment override 
operator. 


/ no expr | expr2 Integer division with truncation of 
the fractional part. 
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Relocatable 
Values 


Operator Permitted Syntax Description 


expr1 * expr2 


. one operand = expr + expr2 Addition. 
only 


Integer multiplication. 


Subtraction — both operands may be 
relocatable only if they are relative 
to the same segment, in which case 
the result is absolute. If one operand 
is relocatable, it must be the 
lefthand one. 


+(unary) yes + expr Unary addition. 
-(unary) 10 - expr Unary subtraction. 


M i dy :| yes -TYPE expr Returns a byte defining the mode and 
scope of expr. 


exprl - expr2 


AND no expr1 AND expr2 Bitwise AND of the two operands. 
EQ no expr1 EQ expr2 Returns -1 if expressions are equal, 


zero if not equal. 


GE no expr1 GE expr2 Returns -1 if expr1 is greater than or 
equal to expr2, zero otherwise. 


GT no expr1 GT expr2 Returns -1 if expr1 is greater than 
expr2, zero otherwise. 


HIGH no HIGH expr Returns the high eight bits of a 16 
bit value. 

HIGHW_ ro HIGHW expr Returns the high 16 bits of a 32 bit 
value. 
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Relocatable 
Values 


Operator Permitted Syntax 


LE no expr1 LE expr2 Returns -1 if expr1 is less than or 
equal to expr2, zero otherwise. 


LENGTH yes LENGTH varname Returns the number of elements in 
the variable, where a variable has 
more than one element by use of the 
DUP operator in the variable 
declaration statement, or by use of a 
list of initializers. 


LOW expr Returns the low eight bits of a 16 bit 
value. 


LOWW expr Returns the low 16 bits of a 32 bit 
value. 


expr1 LT expr2 Returns -1 if expr1 is less than expr2, 
zero otherwise. 


MASK recnm Returns a bit mask for all the 

defined bits in a record, or for the 
einai cael bits in a record occupied by the 
specified field. 


expr1 MOD expr2 Modulo operator — returns the 
remainder after integer division. 


expr1 NE expr2 Returns -1 if the expressions are not 
equal, zero if they are equal. 


NOT no NOT expr One’s complement of the operand. 


OFFSET yes Returns the number of bytes between 
the operand and the beginning of the 
segment in which it is defined. The 
returned value is relocatable. 
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Relocatable 
Values 


Operator Permitted Syntax 


yes Bitwise OR of the two operands. 


Forces the expression to have the 
specified data type, where type is 
one of the set {BYTE, WORD, 
DWORD, PWORD, QWORD, 
TBYTE, NEAR FAR} or is an integer 
value which corresponds to the data 
type (please see the TYPE operator). 


Returns the segment selector for the 
segment to which expr is relative. 
The result is relocatable. 


expr1 SHL expr2 Shifts expr1 to the left by the number 
of bits specified by the value of 
expr2. Bits shifted off the end of the 
expression are lost. 


SHORT label Forces the assembler to generate a 
one-byte offset in JMP instructions. 
Only necessary for forward 
references. 


expr1 SHR expr2 Shifts expr1 to the right by the 
number of bits specified by the value 
of expr2. Bits shifted off the end of 
the expression are lost. 
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Relocatable 
Values 


Operator Permitted 


SIZE 
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yes 


TABLE H-1, CONTINUED 


Syntax 


SIZE varname 


THIS type 


WIDTH recordname 
WIDTH recfldname 


expr1 XOR expr2 


Returns the number of bytes 
allocated for the specified variable. 
Equal to (LENGTH varname)*(TYPE 
varname). 


Creates an operand whose offset and 
segment values are equal to the 
current location counter value, and 
whose data type is given by one of 
the set {BYTE, WORD, DWORD, 
PWORD, QWORD, TBYTE, NEAR, 
FAR}. 


Returns a number representing the 
data type of expr. If the data type is 
a variable data type, the size in 
bytes of that data type is returned. 
If the data type is a label data type, 
-1 is returned for NEAR and -2 for 
FAR. 


Returns the width, in bits, of 
specified record or record field. 


Bitwise exclusive OR of the two 
operands. 
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TABLE H-2 
OPERATOR PRECEDENCE 


Operator Precedence 


LENGTH, SIZE, WIDTH, MASK, [ ] 


. (structure field name) 


: (segment override) 


OFFSET, SEG, TYPE, THIS 
HIGH, LOW, HIGHW, LOWW 
unary +, unary - 

PTR 

* /, MOD, SHL, SHR 

+,- 

EQ, NE, LT, LE, GT, GE 

NOT 

AND 

OR, XOR 

SHORT, .TYPE lowest 
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Symbol Types 


User-defined symbols have a symbol type that is implicit in the way the 
symbol is defined. Table I-1 lists the symbol types supported by 3861 ASM. 


TABLE I-1 
SYMBOL TYPES 


Directive(s) Used to 


Symbol Type Description Create Symbol 


Name of a group used to group one or more GROUP 
segments. 


segment Name of a segment. Carries attributes of SEGMENT 
align type, combine type, protection, etc. 


variable Address of data within a particular DB, DW, DD, DQ, DP, 
segment. Carries a data type of BYTE, DF, DT, LABEL, EQU, = 
WORD, DWORD, PWORD, QWORD, or 

TWORD. 


structure Address of data area allocated by name of structure 
invoking a structure definition template. definition 


record Address of data area allocated by name of record definition 
invoking a record definition template. 


Address within a segment used for control LABEL, =, EQU 
transfer by JMP or CALL instructions. 
Carries a data type of NEAR or FAR. 


procedure label Exactly the same as label. PROC 


255 


Symbol Types 


TABLE I-1, CONTINUED 


Directive(s) Used to 


SymbolType Description Create 


constant 


alias 


A constant integer value. 


Another name for an assembler reserved EQU 
word. 


text substitution A string of ASCII text that is substituted EQU 


structure 
definition 


structure field 


record 
definition 


record field 
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for the symbol name wherever it is used. 


A name of a macro definition which, 
when invoked, causes the macro to be 
expanded. 


A name of a structure definition template STRUC 
which, when invoked, causes allocation 

and initialization of a data area whose 

size and initial values are defined in the 
template. 


A name of a field within a structure DB, DW, DD, DQ, DP, 
template. Carries a data type (BYTE, DF DT within a structure 
WORD, DWORD, PWORD, QWORD. definition block 
TWORD), the offset it is located at 

within the structure template, and an 

initial value. 


A name of a record definition template RECORD 
which, when invoked, causes allocation 

and initialization of an 8 bit, 16 bit or 32 

bit data area. 


A name of a bit field within a record 
template. Carries the offset (in bits) 
where it is located in the record 

template, a width (in bits), and an initial 
value. 
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Mixing USE16 and USE32 
Segments 


Instructions in USE16 segments use 16 bit operands and addressing modes 
by default. Instructions in USE32 segments use 32 bit operands and 
addressing modes by default. However, the alternate form of either the 
operand size or the addressing mode can be selected independently by 
prefixing the instruction with either (or both) an operand size override 
byte or an address size override byte. 386! ASM automatically generates 
these override bytes as necessary. This appendix discusses some of the 
issues that arise in the case of the 16 bit and 32 bit forms of certain 
instructions, and in the interactions between code in USE16 and USE32 
segments. 


J.1  Intersegment Procedure Calls 


When a FAR procedure call is made between segments with different use 
types, 3861 ASM generates the form of the CALL instruction which 
corresponds to the use type of the destination segment. This means that 
the default form of the RET instruction can always be used, regardless of 
whether the procedure was called from a segment with a different use 


type. 
Example: 
csegl SEGMENT usel6 
pl PROC far 
ret ; 16 bit far return 
pl ENDP 


csegl ENDS 


cseg2 SEGMENT use32 
call pl ; assembler automatically 
; generates 16 bit form 
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; of far call instruction 
cseg2 ENDS 


cseg3 SEGMENT usel6 
call pl ; 16 bit form of call 
cseg3 ENDS 


This works nicely on FAR calls from a USE16 segment to a USE32 
segment. The CALL pushes the full 32 bits of EIP onto the stack, and the 
RET (in the USE32 segment) restores it. Note, however, that there is a 
potential problem with FAR calls from a USE32 segment to a USE16 
segment. Since the 16 bit form of CALL and RET are used, only IP (not 
EIP) is saved on the stack and restored. Thus, if any code changes the high 
16 bits of EIP between the CALL and the RET, the RET will not restore 
control to the correct location! Normally this is not a problem since, 
when executing in a USE16 segment, there is no reason to modify the 
high 16 bits of EIP. There is a workaround if it is possible that the high 16 
bits of EIP might be modified. 386! ASM can be forced to generate the 32 
bit form of the CALL by using an indirect call (please see J.2). The 32 bit 
form of the RET can be forced by hardcoding an operand size override byte 
before the RET instruction. Note that if this is done, the procedure can no 
longer be called with a 16 bit form of the CALL instruction! 


Example: 
csegl SEGMENT usel6 
pl PROC far 
DB 66h ; operand size override 
ret ; gives 32 bit form 
; of return 
pl ENDP 


csegl ENDS 


dseg SEGMENT 

pl_call LABEL pword ; indirect 32 bit far call 
DD OFFSET pl 
DW csegl 


dseg ENDS 
cseg2 SEGMENT USE32 


call pl_call ; force 32 bit form 
; of call 
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cseg2 ENDS 


cseg3 SEGMENT USE16 
call pl ; this won't work 
* because of 32 bit 
; return in proc pl 
cseg3 ENDS 


J.2 Indirect Control Transfer 


Indirect calls and jumps in protected mode pose an ambiguity problem for 
the assembler because of the possibility of mixing USE16 and USE32 
segments in the same program. When making an indirect call/jump 
from a USE16 segment, the data type of the variable being used with the 
indirect call/jump can be used to decide what form of the instruction to 
generate. 


Variable Data Type Call/Jump 


WORD NEAR call/jump to USE16 segment 
DWORD FAR call/jump to USE16 segment 
PWORD/FWORD FAR call/jump to USE32 segment 


When making an indirect call/jump from a USE32 segment, however, 
the data type is ambiguous. 


Variable Data Type Call/Jump 


DWORD FAR call/jump to USE16 segment 
DWORD NEAR call/jump to USE32 segment 
PWORD/FWORD FAR call/jump to USE32 segment 


3861 ASM, therefore, uses the convention that an indirect call/jump 
through a variable of type WORD when executing in a USE32 segment 
means a far call/jump to a USE16 segment. Table J-1 summarizes how 
data types determine the type of instruction generated for an indirect 
call/jump. The following example generates all three kinds of indirect 
control transfers from a USE32 segment. 
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Example: 
data SEGMENT 
far32 DP ? ; seg:offset in USE32 seg. 
near32 DD ? ; offset in USE32 seg. 
farl6 DD ? ; seg:offset in USE16 seg. 
data ENDS 
code SEGMENT use32 
call far32 ; FAR call to USE32 seg. 
jmp near32 ; NEAR jump within seg. 
call word PTR farl6 ; force FAR call to 
; USE16 seg. 
code ENDS 


TABLE J-1 
INDIRECT CONTROL TRANSFER DATA TYPES 


Use Type of 
Segment Call Variable Data Type of Control 
is Made From Transfer Generated 


NEAR call/jump within USE16 segment 
FAR call/jump to another USE16 segment 
PWORD/FWORD _ FAR call/jump to a USE32 segment 
16 bit register NEAR call/jump within USE16 segment 
32 bit register illegal 
WORD FAR call/jump to a USE16 segment 
DWORD NEAR call/jump within USE32 segment 
PWORD/FWORD _ FAR call/jump to another USE32 segment 


16 bit register illegal 
32 bit register NEAR call/jump within USE32 segment 
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J.3. Data Width for Stack PUSH/POP 


The 80386 processor pushes either WORD (16 bit) or DWORD (32 bit) 
values on the stack. The default operand size for PUSH/POP (as for all 
instructions) is WORD when executing in a USE16 segment, DWORD for 
a USE32 segment. If the operand to the PUSH/POP instruction does not 
have a data type, 386! ASM will not generate an operand size override 
byte, so the default operand size will be pushed/popped. The PTR 
operator can be used to give the operand a data type of DWORD or WORD 
to force the assembler to use the desired operand size. 


Example: 
cseg SEGMENT use32 
push 0 ; push a DWORD 
push word PTR 0 ; push a WORD 
push dword PTR 0 ; push a DWORD 
cseg ENDS 


When segment registers are pushed and popped, the 80386 pushes/pops 
16 bits when executing in a USE16 segment, and 32 bits (of which the high 
16 bits are unused and pushed as zero) in a USE32 segment. It is 
permissible to use an operand size override byte to change the default 
operand size, but 386! ASM does not provide any automatic way to 
generate an override byte. If an override byte is desired, it must be coded 


with a DB. 
Example: 
csegl6 SEGMENT usel6 
push ds ; push 16 bits 
pop ax 
cseg ENDS 
cseg32 SEGMENT use32 
push eax 
pop ds ; pop 32 bits 
DB 66h ; operand size override 
push ds ; push 16 bits 
cseg32 ENDS 
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The PUSHF/POPF (push/pop flags) instructions also have two forms: the 
16 bit form pushes/pops the low 16 bits of the EFLAGS register; and the 32 
bit form pushes/pops the full 32 bits of the EFLAGS register. Table J-2 
shows what instruction mnemonics are used to generate the desired 
instruction form. The programmer explicitly specifies which form of the 
instruction is to be generated by his choice of instruction mnemonics. 


TABLE J-2 
PUSH/POP FLAGS INSTRUCTIONS 


Instruction Generated 


Push low 16 bits of EFLAGS 


POPF Pop WORD into low 16 bits of EFLAGS 
PUSHFD Push all 32 bits of EFLAGS 


POPFD Pop DWORD into EFLAGS 


Example: 

csegl6 SEGMENT usel6 
pushf ; push low 16 bits of EFLAGS 
popfd ; pop DWORD into EFLAGS 

csegl6 ENDS 

cseg32 SEGMENT use32 
pushfd ; push all 32 bits of EFLAGS 
popf ; pop WORD into low 16 bits of 

; EFLAGS 
cseg 32 ENDS 


J.4 Interrupt Return Instruction 


The interrupt return (IRET) instruction has a 32 bit and a 16 bit form. 
Protected mode interrupt handlers should always use the 32 bit form, and 
real mode interrupt handlers should always use the 16 bit form. 386!ASM 
generates the 32 bit form of the instruction when the IRETD mnemonic is 
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used, and generates the 16 bit form of the instruction when the IRET 
mnemonic is used. 


Example: 
cseg SEGMENT usel6 
iret ; interrupt return for 
; real mode handler 
iretd ; interrupt return for 
; protected mode handler 
cseg ENDS 


J.5 Load/Store Descriptor Table Registers 


The load and store instructions for the GDTR and IDTR registers have a 16 
bit and 32 bit form. The 16 bit form is provided for compatibility with the 
80286 and only loads/stores 24 bits of the descriptor table base address. The 
32 bit form loads/stores a full 32 bit base address. 386! ASM always 
generates the 32 bit form when the suffix “E” is used with the instruction 
mnemonic, and generates the 24 bit form when it is not used. Table J-3 
shows which instruction mnemonics generate which form of the 
instruction. 


TABLE J-3 
DESCRIPTOR TABLE REGISTER INSTRUCTIONS 


Instruction Generated 


16 bit (80286) form of load/store GDTR 


LGDTE/SGDTE 32 bit (80386) form of load/store GDTR 
LIDT/SIDT 16 bit (80286) form of load/store IDTR 
32 bit (80386) form of load/store IDTR 


LIDTE/SIDTE 
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Easy OMF-386 Object File Format 


Easy OMF-386 is the format used by 386! ASM for object files generated for 
the 80386 (object files generated for the 8086, 8088, 80186, and 80286 are in 
OMF-86 format). Easy OMF-386 is a simple extension of the OMF-86 used 
by Intel and Microsoft. This appendix describes the differences between 
Easy OMF-386 and OMF-86. For a description of OMF-86, please see 
references 1 and 2. 


386 | ASM signals to the linker that an object module is targeted for the 
80386 by placing the following comment record at the beginning of an 
object module: 


3 7 8 


0 1 z 
re 


Record Flags Class Checksum 
Type 


where “H” designates a hexadecimal value. 

The 80386 comment record should be located immediately after the 
module header record (THEADR) and before any other records of the 
object module. 


The other records of an object module are formatted in Easy OMF-386 the 
same way as in OMF-86, except that any offset, displacement, or segment 
length field of an object record is four bytes long instead of two bytes. The 
following records contain the fields which increase in size: 


Record: Field: 
SEGDEF Offset and segment length 
PUBDEF Offset 
LEDATA Offset 
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Record: Field: 
LIDATA Offset 
Explicit FIXUPP Target displacement 
BLKDEF Return address offset 
LINNUM Offset 
MODEND Target displacement 
DEBSYM Offset 
LOCSYM Offset 


In FIXUPP records, the following two new “Loc” values have been 
defined: 


5 32 bit offset 
6 Base + 32 bit offset (long pointer) 


In SEGDFF records, the following two new “Align” values have been 
defined: 


5 Relocatable and doubleword-aligned segment 
(segment begins on a doubleword boundary) 

6 Relocatable and 4K page-aligned segment 
(segment begins at an address on a 4096-byte 
boundary) 
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Example 386! ASM 
Command Lines 


1. Assemble the file “HELLO.ASM” to produce an object file 
“HELLO.OB)J” and a listing file “HELLO.LST”: 


IBM PC/MS-DOS: 
386ASM HELLO 


VAX/VMS or UNIX: 
XA386 HELLO 


2. Assemble the file “HELLO.ASM” and discard the listing file: 


IBM PC/MS-DOS: 
386ASM HELLO -NOLIST 


VAX/VMS or UNIX: 
XA386 HELLO -NOLIST 


3. Assemble the file “HELLO.ASM” and discard the object file: 


IBM PC/MS-DOS: 
386ASM HELLO -NOOBJECT 


VAX/VMS or UNIX: 
XA386 HELLO -NOOBJECT 


4. Assemble the file “HELLO.ASM” for the 8086: 


IBM PC/MS-DOS: 
386ASM HELLO -8086 


VAX/VMS or UNIX: 
XA386 HELLO -8086 
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5. Assemble the file “HELLO.ASM” and redirect the listing and object 
files to another directory: 


IBM PC/MS-DOS: 

386ASM HELLO -LIST \LISTINGS\HELLO -OBJECT \OBJS\HELLO 
VAX/VMS: 

XA386 HELLO -LIST [LISTINGS]HELLO -OBJECT [OBJS]HELLO 
UNIX: 


X386ASM HELLO -LIST /LISTINGS/HELLO -OBJECT /OBJS/HELLO 


6. Assemble the file “HELLO.ASM” and write all errors to the file 
“HELLO.ERR”: 


IBM PC/MS-DOS: 
386ASM HELLO -ERRORLIST HELLO 


VAX/VMS or UNIX: 
XA386 HELLO -ERRORLIST HELLO 
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.186 directive, 92 
.286C directive, 92 
.286 directive, 92 
.286P directive, 92 
.287 directive, 94 
.386C directive, 93 
.386 directive, 93 
.386P directive, 93 
8086 directive, 91 
-8086 switch, 10 
.8087 directive, 94 
-8087 switch, 12 
-80186 switch, 10 
-80286P switch, 11 
-80286 switch, 10-11 
-80287 switch, 12 
-80386P switch for, 11-12 
-80386 switch, 11 
-80387 switch, 13 
& (ampersand) 
to separate parameters, 142-43 
<> (angle brackets) 
as literal text operator, 144-45 
* (asterisk) 
as multiplication operator, 114-15 
[] (brackets) 
for indirection operator, 128 
: (colon) 
to create instruction labels, 54 


as segment override operator, 112, 123-25 


" (double quotation mark) 
for string constants, 31 
as string operator, 147 
= (equal sign) directive, 23, 51-52 
to create instruction labels, 55-56 
to create variables, 73-74 
! (exclamation point) 
as literal character operator, 144 
< (left angle bracket) 


as literal text operator, 145 
to terminate parameter lists, 144 
- (minus sign) 
as subtraction operator, 114-15 
in switches, 3, 5 
% (percent sign) 
as expression operator, 146-47 
. (period) 
as structure field operator, 122 
+ (plus sign) 
as addition operator, 114-15 
used with PAGE directive, 96 
# (pound character) 
in names of local symbols, 27 
in procedure blocks, 60-61 
? (question mark) 
for undefined storage operand, 71 
> (right angle bracket) 
as literal text operator, 145 
* (semicolon) 
for macros and repeat block comments, 140 
for source file comments, 26 
' (single quotation mark) 
for string constants, 31 
as string operator, 147 
/ (slash) 
as division operator, 114-15 
[] (square brackets) 
for indirection operator, 128 


oo 


2 ge Sets mene 
_A8 6 file name extension, 3 
ABS keyword, 88-89 
absolute constants 
EQU directive for, 49-50 
access type specifiers, 40 
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addresses 
for paragraphs, 150 
address expressions 
control transfers to, 56-57 
address modes, 129 
based index mode, 131-32 
based scaled index mode, 132-33 
immediate operand mode, 129-30 
memory direct mode, 130 
register direct mode, 130 
register indirect mode, 131 
scaled index mode, 132 
alias constants, 22-24 
aliases 
for assembler keywords, 50-51 
ALIGN directive, 47 
align type specifiers, 36-37 
ampersand (&) 
to separate parameters, 142-43 
AND bitwise operator, 115-16 
angle brackets (<>) 
as literal text operator, 144-45 
arithmetic operators, 113-15 
.ASM file name extension, 3 
assembler control directives, 91 
conditional assembly directives, 100-105 
conditional error directives, 105-7 
instruction set directives, 91-94 
list file control directives, 95-99 
miscellaneous control directives, 107-8 
assembler errors, 105-7 
assembler keywords 
aliases for, 50-51 
assembler reserved names, 195-96 
assembler reserved words, 111-12 
assembly 
case-sensitivity switches for, 13-14 
errors generated during, 165 
assembly language, 149 
ASSUME directive, 44-45, 123 
asterisk (*) 
as multiplication operator, 114-15 
AT combine type specifier, 38-39 
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B 


based index mode, 131-32 
based scaled index mode, 132-33 
base registers, 129 
bitwise operators, 114-16 
brackets ([]) 
for indirection operator, 128 
BYTE align type, 37 
DB directive for, 64 
BYTE data type, 244 


C 


CALL instruction, 57 
case-sensitive processing 

switches for, 13-14 
characters 

in character strings, 31 

literal character operator (!) for, 144 

special, in listing files, 17-20 

in user-defined symbols, 26-27 
character set, 195 
class specifiers, 40-41 
colon (:) 

to create instruction labels, 54 

as segment override operator, 112, 123-25 
combine type specifiers, 37-39 
command line 

example of, 265-66 

switches for, 163 

syntax of, 3-4 
COMMENT directive, 35 
comments 

in macros and repeat blocks, 140 

in source file statements, 26 
COMMON combine type specifier, 38 
conditional assembly directives, 100-1 

ELSE, 104-5 

ENDIF, 105 

IF, 101 

IFB, 103 

IFDEF, 102 

IFDIF, 104 

IFE, 101-2 
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conditional assembly directives, cont. 
IFIDN, 104 
IFNB, 103 
IFNDEF, 102 
conditional blocks, 99 
conditional error directives, 105-7 
conditional parameters, 100 
constant operands, 109-10 
constants, 27-28, 198-200 
encoded real, 30-31 
EQU directive to define, 49-50 
integer, 28-29 
in procedure symbol table, 22 
real, 29-30 
string, 31 
constant symbol tables, 23-24 
control transfer instructions, 53 
indirection used in, 57 
instruction labels for, 53-57 
to transfer control to address expressions, 56-57 
CS register, 44, 150-52, 156-57 
error messages regarding, 177 


D 


data declaration directives, 63 
to create variables, 71-72 
DB, 64 
DD, 66-67 
DF and DP, 67-68 
DQ, 68-69 
DT, 69-70 
DUP operator used with, 70-71 
DW, 65 
data structures 
defining fields within, 76-77 
ENDS directive for, 75 
referencing, 79-80 
STRUC directive for, 75 
structure definitions for, 74-75, 77-79 
data types, 243-45 
data declaration directives for, 63-70 
of external symbols, 88 
PTR operator for, 120-21 
THIS operator for, 127 
TYPE operator for, 120 
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DB directive, 64 
DD directive, 66-67 
defaults, 3-5 
-DEFINE switch, 14-15 
delimiters, 198 
DF directive, 67-68 
digits, 28 
directives, 227-37 
= (equal sign), 51-52 
ASSUME, 44-45 
COMMENT, 35 
conditional assembly, 100-5 
conditional error, 105-7 
data declaration, 63-70 
END, 33 
ENDP, 59-60 
ENDS, 41-42, 75 
EQU, 49-52 
EXITM, 141-42 
EXTERN, 88-89 
GROUP, 43-44 
INCLUDE, 34 
instruction set, 9, 91-94 
IRP, 139 
LABEL, 54-55 
list file control, 95-99 
LOCAL, 140-41 
location counter control, 45-47 
MACRO, 135 
miscellaneous control, 107-8 
NAME, 32 
PROC, 58-59 
PUBLIC, 87-88 
PURGE, 142 
RECORD, 80-82 
REPT, 138 
SEGMENT, 35-36 
STRUC, 75 
directories 
-INCLUDE switch to include in searches, 8-9 
displacements, 129 
double quotation mark (") 
for string constants, 31 
as string operator, 147 
DP directive, 67-68 
DQ directive, 68-69 
DS register, 44, 150-52, 156-57 
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DT directive, 69-70 
DUP operator, 70-71 


error messages regarding, 176, 188, 190 
multiple data structures created by, 78-79 


multiple records crated with, 83-84 
DW directive, 65 
DWORD align type, 37 

DD directive for, 66 
DWORD data type, 244 


Easy OMF-386 format, 1 
object file format for, 263-64 
.8087 directive, 94 
-8087 switch, 12 
.8086 directive, 91 
8086 mode, 1 
-80186 switch, 10 
-80387 switch, 13 
80386 microprocessors 
see Intel 80386 microprocessors 
80386 mode, 2 
-80386P switch, 11-12 
-80386 switch, 11 
-80287 switch, 12 
80286 microprocessors 
see Intel 80286 microprocessors 
80286 mode, 1 
-80286P switch, 11 
-80286 switch, 10-11 
ELSE directive, 100-101, 104-5 
error messages regarding, 170 
encoded real constants, 30-31 
encoded real numbers, 199 
END directive, 25-26, 33 
ENDIF directive, 100, 101, 105 
error messages regarding, 167, 170 
ENDM directive, 135, 138, 139 
error messages regarding, 167, 169 
ENDP directive, 59-60 
ENDS directive 
in segment definitions, 35-36, 41-42 
in structure definitions, 75 
EO access type specifier, 40 
EQ relational operator, 117 
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equal sign (=) directive, 23, 51-52 

to create instruction labels, 55-56 

to create variables, 73-74 
EQU directive, 14, 23, 49, 50 

= (equal sign) directive and, 51-52 

for absolute constants, 49-50 

for aliases for assembler keywords, 50 

to create instruction labels, 55-56 

examples of use of, 51 

for text substitution symbols, 50 
ER access type specifier, 40 
-ERRB directive, 106 

error messages regarding, 186 
-ERRDEF directive, 106 

error messages regarding, 186 
.ERRDIF directive, 107 

error messages regarding, 186 
.ERR directive, 105 

error messages regarding, 185 
-ERRE directive, 105 

error messages regarding, 186 
.ERR file name extension, 3 
-ERRIDN directive, 107 

error messages regarding, 186 
-ERRNB directive, 106 

error messages regarding, 186 
-ERRNDEF directive, 106 

error messages regarding, 186 
-ERRNE directive 

error messages regarding, 186 
-ERRNZ directive, 106 
error checking 

-FULLWARN switch for, 15 
error list file switch, 8 
-ERRORLIST switch, 8 
error messages, 3, 165 

-ERRORLIST switch for, 8 

for fatal errors, 191-93 

in listing files, 16 

for severe errors, 172-91 

for warning errors, 165-71 
errors 

conditional error directives for, 105-7 

indicated in listing files, 16 
escape characters 

literal character operator (!) for, 144 
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ES register, 44, 150 
error messages regarding, 185 
EVEN directive, 46 
exclamation point (!) 
as literal character operator, 144 
EXITM directive, 141-42 
exponents, 30 
expression operator (%), 146-47 
expressions, 109 
address modes for, 129-33 
arithmetic operators, 113 
assembler reserved words, 111-12 
bitwise operators, 114-16 
constant operands, 109-10 
forward references, 112-13 
indirection operator ([]), 128 
LENGTH and SIZE operators, 117-18 
OFFSET operator, 125 
operands, 109-10 
operators, 113, 245-51 
PTR operator, 120 
relational operators, 117 
relocatable operands, 110 
segment override operator (:), 123-25 
SEG operator, 121 
SHORT operator, 126-27 
structure field operator (.), 122 
THIS operator, 127 
TYPE operator, 120 
-TYPE operator, 127 
WIDTH and MASK operators, 119 
external symbols, 87, 88-89 
redefining as public symbols, 90 
EXTERN directive, 87, 88-89 
extra error checking switch, 15 
EXTRN directive, 23 


F 


false conditional blocks, 99 

FAR instruction, 152 

fatal errors, 165 
messages for, 191-93 

fields 
in data structures, 76-77, 79-80 
RECORD directive for, 80-82 
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file name extensions, 3 
file names, 3 
-LIST switch for, 6-7 
-OBJECT switch for, 5 
files 
in Easy OMF-386 format, 263-64 
INCLUDE directive to copy text between, 34 
floating-point format, 28, 30 
directives for, 94 
error messages regarding, 168 
forced errors, 185-86 
forward references in expressions, 112-13 
FS register, 44, 150 
-FULLWARN switch, 15 
FWORD data type, 244 


G 


GE relational operator, 117 
global descriptor table (GDT), 156, 159 
global symbols, 87-88 
EXTERN directive for, 88-89 
PUBLIC directive for, 87-88 
redefining external symbols as public symbols, 


graphics characters, 31 

group and segment symbol tables, 20 
GROUP directive, 43-44 

GS register, 44, 150 

GT relational operator, 117 


H 


hexadecimal numbers, 28 
HIGH bitwise operator, 116 
HIGHW bitwise operator, 116 


IBM PC/AT computers, 1 
IBM PC computers, 1 
identifiers, 197 

IFB directive, 103 
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IFDEF directive, 14, 102 
IFDIF directive, 14, 104 
IF directive, 101 
error messages regarding, 170, 185 
IFDN directive, 14 
IFE directive, 101-2 
IFIDN directive, 104 
IFNB directive, 103 
IFNDEF directive, 14, 102 
immediate operand mode, 129-30 
INCLUDE directive, 34 
-INCLUDE switch used with, 8-9 
include search directory switch, 8-9 
-INCLUDE switch, 8-9 
index registers, 129 
error messages regarding, 182 
indirect control transfers, 57, 257-58 
indirection operator ([]), 128 
initializers, 77-78 
input source files 
see source files 
instruction labels, 53-54 
for control transfers to address expressions, 56- 
57 
for control transfers using indirection, 57 
creating with colon (:), 54 
creating with EQU and equal sign (=) directives, 
55-56 
creating with LABEL directive, 54-55 
instruction sets 
directives for, 91-94 
for Intel 80287 numeric coprocessors, 219-25 
for Intel 80386 microprocessors, 201-18 
labels as operands for, 53 
switches for, 9-13 
integer constants, 23-24, 28-29 
integers, 28-29, 198 
Intel 8086 microprocessors, 1 
-8086 switch for, 10 
.8086 directive for, 91 
real-mode programming of, 149 
Intel 8086 Object Module Format (OMF-86), 1 
Intel 8087 numeric coprocessors 
-8087 switch for, 12 
.8087 directive for, 94 
real numbers encoded in floating-point format 
for, 30 
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Intel 8088 microprocessors, 1 
real-mode programming of, 149 
Intel 80186 microprocessors, 1 
.186 directive for, 92 
-80186 switch for, 10 
real-mode programming of, 149 
Intel 80188 microprocessors, 1 
real-mode programming of, 149 
Intel 80286 microprocessors, 1 
.286 and .286C directives for, 92 
.286P directive for, 92 
-80286P switch for, 11 
-80286 switch for, 10-11 
.PROT directive for, 93 
protected-mode programming of, 159 
real-mode programming of, 149 
Intel 80287 numeric coprocessors 
.287 directive for, 94 
-80287 switch for, 12 
instruction set for, 219-25 
real numbers encoded in floating-point format 
for, 28, 30 
Intel 80386 microprocessors, 2 
.386 and .386C directives for, 93 
386 | ASM for, 1-2 
.386P directive for, 93 
-80386P switch for, 11-12 
-80386 switch for, 11 
control transfer instructions in, 53 
Easy OMF-386 object file format for, 263-64 
instruction set for, 201-18 
.PROT directive for, 93 
protected-mode programming of, 155-59 
real-mode operation of, 149-55 
real-mode programming of, 160-61 
registers in, 239-41 
Intel 80387 numeric coprocessors 
.387 directive for, 94 
-80387 switch for, 12 
Intel 80486 microprocessors, 1 
Intel microprocessors 
3861 ASM for, 1 
address modes for, 129-33 
base and index registers in, 129 
instruction set directives for, 91-94 
instruction set switches for, 9-13 
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Intel microprocessors, cont. 
protected-mode programming of, 155-59 
real-mode programming of, 149-55 

intersegment procedure calls, 255-57 

INT instruction, 152 

IRET instruction, 152, 260-61 

IRP directive, 139 
lists of parameters for, 144 

IRPC directive, 138-39 


JMP instruction, 57 


keywords 
aliases for, 50 


LABEL directive, 54-55 
to create variables, 72-73 
labels 
instruction labels, 53-57 
in procedure symbol table, 22 
in variable and label symbol table, 23 
-LALL directive, 99 
left angle bracket (<) 
as literal text operator, 145 
to terminate parameter lists, 144 
LENGTH operator, 117-18 
LE relational operator, 117 
.LFCOND directive, 98 
linear addresses, 150, 156 
.LIS file name extension, 3 
LIST directive, 97 
.LISTI directive, 97-98 
listing files, 15-16 
constant symbol tables in, 23-24 
control directives for, 95 
error messages written to, 3, 165 
group and segment symbol tables in, 20 
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-LALL directive for, 99 
.LFCOND directive for, 98 
-LIST directive for, 97 
-LISTI directive for, 97 
macro symbol tables in, 21-22 
PAGE directive for, 96-97 
page headers in, 16-17 
procedure symbol tables in, 22-23 
record symbol tables in, 21 
SALL directive for, 99 
SSFCOND directive for, 98 
statement lines in, 17, 19-20 
structure symbol tables in, 20-21 
SUBTTL directive for, 95-96 
switches for, 6-7 
.TFCOND directive for, 99 
TITLE directive for, 95 
variable and label symbol tables in, 23 
XALL directive for, 99-100 
.XLIST directive for, 97 
.XLISTI directive for, 98 
-LIST switch, 6-7 
literal character operator (!), 144 
literal text operator (<>), 144-45 
load /store descriptor table registers, 261 
local descriptor table (LDT), 156, 159 
LOCAL directive, 140-41 
local symbols, 27 
error messages regarding, 189 
in procedure blocks, 58, 60-61 
local variables, 22 
location counter control directives, 45 
ALIGN, 47 
EVEN, 46 
ORG, 45-46 
LOW bitwise operator, 116 
LOWW bitwise operator, 116 
LST file name extension, 3 
.LST files 
see also listing files 
error messages written to, 165 
LT relational operator, 117 
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M 


MACRO directive, 135 

macros, 135 
comments in, 140 
EXITM directive for, 141-42 
expression operator (%) in, 146-47 


list file control directives regarding, 99-100 


literal character operator (!) in, 144 
literal text operator (<>) in, 144-45 
LOCAL directive for, 140-41 
macro definitions, 135-36 
macro expansions, 136-38 
parameter lists for, 143-144 
parameter substitution in, 142-43 
string operators (' and ") in, 147 
macro symbol tables, 21-22 
MASK operator, 119 


MASM compatible assembly language source 


code, 1 
memory 
record names to allocate, 82-83 
structure names to allocate, 77 
MEMORY combine type specifier, 38 
memory direct mode, 130 
microprocessors 
address modes for, 129-33 
base and index registers in, 129 
instruction set directives for, 91-94 
instruction set switches for, 9-13 
real-mode programming of, 149-55 
386 | ASM on, 1, 1-2 
minus sign (-) 
as subtraction operator, 114-15 
in switches, 3,5 
MOD operator, 114-15 
modules 
global symbols for, 87 
names for, 32 
SEGMENT directive for, 35-36 
MS-DOS 
file name extensions for, 3 
protected-mode programming in, 155-59 
real-mode programming in, 149-55 
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NAME directive, 32 
names 
see also file names 
for instruction labels, 53 
for macros, 135, 136 
for modules, 32 
for records, 82-83 
reserved, 195-96 
for structures, 77 
NEAR instruction, 152 
NE relational operator, 117 
nesting 
of segment definitions, 36 
-NO87 switch, 13 
-NODELETE switch, 6 
-NOLIST switch, 7 
-NOOBJECT switch, 5-6 
-NOSYM switch, 7 
NOT bitwise operator, 115-16 
NOTHING keyword, 44 
numbers 
arithmetic operators for, 113-15 
bitwise operators for, 114-16 
as constants, 28-31, 198-200 
-RADIX directive for, 107-8 
numeric coprocessors 
directives for, 94 
switches for, 12-13 


O 


.086 file name extension, 3 
object code 


generated by macro expansion, 136 


in listing files, 15-16 
object files 
in Easy OMF-386 format, 263-64 


source file statements represented in, 25-26 


switches for, 5-6 

object modules, 1 

-OBJECT switch, 5 

OBJ file name extension, 3 
-NODELETE switch for, 6 
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OFFEST operator, 125-126 
OMF-86 (Intel 8086 Object Module Format), 1 
differences between Easy OMF-386 object file 
format and, 263-64 
-ONECASE switch, 14 
.186 directive, 92 
operands, 109-10 
assembler reserved words as, 111-12 
constant operands, 109-10 
error messages regarding, 180, 181, 182 
forward references in, 112-13 
relocatable operands, 109-11 
undefined storage operand (?), 71 
operators, 113, 245-51 
arithmetic, 113-15 
bitwise, 114-16 
DUP, 70-71, 78-79, 83-84 
expression operator (%), 146-47 
indirection operator ([]), 128 
LENGTH and SIZE, 117-18 
literal character operator (!), 144 
literal text operator (<>), 144-45 
OFFSET, 125-126 
PTR, 120-21 
relational, 117 
SEG, 121-22 
segment override operator (:), 123-25 
SHORT, 126-27 
string operators (‘ and "), 147 
structure field operator (.), 122 
THIS, 127 
TYPE, 120 
.TYPE, 127-128 
WIDTH and MASK, 119 
OR bitwise operator, 115-16 
ORG directive, 45-46 
error messages regarding, 191 
%OUT directive, 107 
output listing files, 3 


P 


packed decimal numbers, 28-29 
PAGEAK align type, 37 
PAGE align type, 37 
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PAGE directive, 96-97 
for pages in listing files, 16 
page headers 
indicated in listing files, 16-17 
SUBTTL directive for, 95-96 
TITLE directive for, 95 
paging, 156 
PARA align type, 37 
paragraphs, 150 
parameters 
for ASSUME directive, 44 
conditional, 100 
for ENDS directive, 41 
error messages regarding, 185 
for GROUP directive, 43 
IRP directive for, 139 
lists of, 143-44 
literal character operator (!) for, 144 
literal text operator (<>) for, 144-45 
for macros, 135 
for PROC directive, 58-59 
for SEGMENT directive, 35-36 
string operators (' and ") for, 147 
substitution of, in macros, 142-43 
paths, 3 
percent sign (%) 
as expression operator, 146-47 
period (.) 
as structure field operator, 122 
plus sign (+) 
as addition operator, 114-15 
used with PAGE directive, 96 
pound character (#) 
in names of local symbols, 27 
in procedure blocks, 60-61 
PROC directive, 58-59 
procedure blocks, 58 
ENDP directive for, 59-60 
local symbol definitions in, 60-61 
PROC directive for, 58-59 
procedures 
intersegment calls for, 255-57 
local symbols in, 27 
procedure symbol tables, 22-23 
processors 
see microprocessors 
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programming register indirect mode, 131 
80386 in real mode, 160-61 registers 
protected mode, 155-59 address modes for, 129-33 
real mode, 149-55 ASSUME directive for, 44-45 
programs in 80386 microprocessors, 155, 156-57 
procedure blocks in, 58 in Intel 80386 microprocessors, 239-41 


program statements load/store descriptor table registers, 261 


see statements 
PROT directive, 93 
protected instructions, 10 

.PROT directive for, 93 
PTR operator, 74, 120-21 

for forward references, 112 
PUBLIC combine type specifier, 37 
PUBLIC directive, 23, 87-88, 90 
public symbols, 87-88 

error messages regarding, 180 

redefining as external symbols, 90 
PURGE directive, 142 
PWORD data type, 244 

DF and DP directives for, 67 


Q 


question mark (?) 
for undefined storage operand, 71 
QWORD data type, 244 


DQ directive for, 68 
R 
-RADIX directive, 28, 107-8 
radix specifiers, 28 


real constants, 29-30 

real-mode programming, 149-55 
operations of 80386 in, 160-61 

real numbers, 29-31, 29-30, 199 

record declarations, 82 

RECORD directive, 80-82 


segment registers, 149-51 
relational operators, 117 
relocatable operands, 109-11 
repeat blocks, 135 

comments in, 140 

EXITM directive for, 141-42 

IRP directive for, 139 

REPT directive for, 138 
REPT directive, 138 
reserved names, 195-96 
reserved words, 111-12 
RET instruction, 152 

in procedure blocks, 58 
right angle bracket (>) 

as literal text operator, 145 
RO access type specifier, 40 
RW access type specifier, 40 


SALL directive, 99 

scaled index mode, 132 

scale factors, 129 

SEGMENT directive, 35-36 

segment override operator (:), 123-25 
for forward references, 112 

segment registers, 149-51, 156 
ASSUME directive for, 44-45 
-FULLWARN switch for, 15 

segments, 25-26 
access type specifiers for, 40 
align type specifiers for, 36-37 
class specifiers for, 40-41 


records combine type specifiers for, 37-39 
multiple, created with DUP operator, 83-84 in group and segment symbol table, 20 
referencing, 84-85 in protected-mode programming, 155-57 


in real-mode programming, 149 
segment override operator (:) for, 123-25 


record symbol tables, 21 
record variables, 21 
register direct mode, 130 
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segments, cont. 
SEG operator for, 121-22 
use attribute specifiers for, 39-40 
segment selectors, 150, 156 
SEG operator, 121-22 
semicolon (>) 
for macros and repeat block comments, 140 
for source file comments, 26 
severe errors, 165 
messages for, 172-91 
SSFCOND directive, 98 
SHL bitwise operator, 116 
SHORT operator, 126-27 
error messages regarding, 184 
SHR bitwise operator, 116 
single quotation mark (’) 
for string constants, 31 
as string operator, 147 
SIZE operator, 117-18 
TYPE operator as synonym for, 120 
slash (/) 
as division operator, 114-15 
source code 
in listing files, 15-16, 15-17, 19-20 
source code statements 
in listing files, 17, 19-20 
in source files, 25-26 
source files 
constants in, 27-31 
file name extensions for, 3 
statement format in, 26 
symbol formation in, 26-27 
special characters, 17-20 
SP register, 151 


square brackets ([]) for indirection operator, 128 


SS register, 44, 150-53 
STACK combine type specifier, 38, 151 
stacks 
data widths for, 259-60 
statements, 195 
list file control directives for, 97-100 
in listing files, 16-17, 19-20 
in source files, format for, 26 
string constants, 31, 200 
string operators (' and "), 147 
STRUC directive, 75 
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structure definitions, 74-75, 77 
to allocate memory, 77 
defining fields within, 76-77 
ENDS directive for, 75 
initializers in, 77-78 
multiple structures in, 77-79 
STRUC directive for, 75 

structure field operator (.), 122 

structure symbol tables, 20-21 

structure variables 
see also data structures 
referencing, 79-80 
in variable symbol table, 20 

SUBTTL directive, 95-96 
for subtitles in listing files, 16-17 

switches, 4, 163 
case-sensitivity, 13-14 
in command line syntax, 3 
error list file, 8 
extra error checking, 15 
to include directories in searches, 8-9 
instruction set, 9-13 
listing file, 6-7 
object file, 5-6 
symbol definition, 14-15 

symbols 
error messages regarding, 173-75 
EXTERN directive for, 88-89 
format for, 26-27 
global, 87-88 
PUBLIC directive for, 87-88 
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redefining external symbols as public symbols, 
90 


switches to define, 14-15 
types of, 253-54 
symbol tables 
constant, 23-24 
group and segment, 20 
macro, 21-22 
-NOSYM switch for, 7 
procedure, 22-23 
record, 21 
structure, 20-21 
variable and label, 23 
syntax errors, 165, 172, 173, 176, 179, 184 


system errors, 191 
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TBYTE data type, 244 
DT directive for, 69 

text 
COMMENT directive for, 35 
%OUT directive for, 107 
INCLUDE directive to copy between files, 34 
literal text operator (<>) for, 144-45 

text constants, 23 

text substitution symbols, 50 

-TFCOND directive, 99 

THIS operator, 127 

.387 directive, 94 

386 | ASM, 1-2 
command line switches for, 4-15, 163 
command line syntax for, 3-4 
listing files created by, 15-16 
source file format for, 25-31 

.386C directive, 93 

.386 directive, 93 

386 | DOS-Extender, 159 

386 | LINK, 25 
align type specifiers for, 36-37 
public and external symbols handled by, 87 

.386P directive, 93 

TITLE directive, 95 

-TWOCASE switch, 14-15, 26 

.80287 directive, 94 

.286C directive, 92 

.286 directive, 92 

.286P directive, 92 

TYPE operator, 120 

-TYPE operator, 127-28 


unary-operator, 114 
unary + operator, 114 
undefined storage operand (?), 71 
UNIX systems 
file name extensions for, 3-4 
3861 ASM on, 1 
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USE16 segments, 159, 160 
data width for stack push/pop operations in, 
259-60 
indirect control transfers in, 257-58 
interrupt return (IRET) instruction in, 260-61 
intersegment procedure calls in, 255-57 
load/store descriptor table registers for, 261 
USE16 use attribute specifier, 39 
USE32 segments, 159 
data width for stack push/pop operations in, 
259-60 
indirect control transfers in, 257-58 
interrupt return (IRET) instruction in, 261 
intersegment procedure calls in, 255-57 
load /store descriptor table registers for, 261 
USE32 use attribute specifier, 39-40 
use attribute specifiers, 39-40 
user-defined symbols 
case-sensitivity switches for, 13-14 
data declaration directives as, 63 
format for, 26-27 
forward references to, 112-13 
in listing files, 15-16 
variables as, 71 
user-defined symbol table, 53 


V 


variable and label symbol tables, 23 
variables 
creating with data declaration directives, 71-72 
creating with EQU and equal sign (=) directives, 
73-74 
creating with LABEL directive, 72-73 
data declaration directives to create, 63 
as operands in control transfer instructions, 57 
referencing, 74 
VAX/VMS systems 
file name extensions for, 3-4 
386 | ASM on, 1 
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W 


warning errors, 165 
-FULLWARN switch for, 15 
messages for, 165-71 

WIDTH operator, 119 

WORD align type, 37 
DW directive for, 65 

WORD data type, 244 

words 
reserved, 111-12 


.XALL directive, 99-100 
.XLIST directive, 97 
.XLISTI directive, 98 

XOR bitwise operator, 116 
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